Repository navigation
Outcome: v0.4.0 — Factory Kit now works natively across Claude and Codex from one portable skill tree.
Why: Factory Kit’s knowledge and workflows were coupled to Claude-specific file layouts and commands. This release makes the Open Agent Skills tree the source of truth, then layers thin host adapters on top, so the same kit can be installed, updated, and diagnosed consistently in Claude, Codex, or both.
Changes
82 files changed, +3507 / −2571
Cross-platform foundations:
- Reorganized all 41 skills into the portable
skills/<name>/SKILL.mdformat, including eight command workflows and twelve specialist workflows. - Added native Claude and Codex plugin manifests and marketplace catalogs over the same canonical skill tree.
- Added the official Linear HTTP MCP configuration for native plugin installs.
Installation and compatibility:
- Expanded the npm installer with explicit
claude,codex,all, and host-detectedautotargets while preserving the original no-argument Claude bootstrap. - Added managed, reversible global guidance that preserves user-owned instructions.
- Added
factory-kit doctordiagnostics for canonical links, native plugins, stale installs, and duplicate-skill risks. - Kept existing Claude slash commands and specialist agents as thin compatibility adapters.
Reliability:
- Added installer and portability coverage for version alignment, Open Agent Skills structure, safe migration, idempotency, guidance updates, and mixed-install warnings.
- Updated docs-sync checks and rewrote the README around cross-platform installation and architecture.
Also included:
- Added the
factory-animationskill for attention budgets, figure/ground, reduced motion, and Astro/Remotion patterns.
Surface: Skills reorganized into canonical directories; command and specialist workflows promoted to portable skills · Agents and commands converted to thin Claude adapters · Bin expanded with universal install, guidance, and doctor flows · Plugin and marketplace manifests added for Claude and Codex