Agent Skills
Stable v2.0.0Use FSD CLI through your coding agent
The fsd-cli skill teaches Codex, Claude Code, Cursor, and other compatible agents how to inspect a project, map a request to a supported FSD operation, run the real CLI, and verify the generated structure before implementing business logic.
Stable scope
Skill v2.0.0 was verified against create-fsd-architecture 2.6.1, the npm release current when it shipped. The current CLI is 2.8.0. Agent behavior can still vary across coding tools and existing project structures, so review generated changes before committing them. Stable refers to the documented workflows and helpers; live backend and broad provider certification remain outside the verified scope.
Install the skill
npx skills@1.7.0 add https://github.com/FSD-CLI/create-fsd-architecture/tree/v2.0.0/skills/fsd-cli --skill fsd-cliThe source lives in the create-fsd-architecture Agent Skill repository. The current stable release is v2.0.0. Its core instructions are portable; agent-specific UI metadata is kept separate. The pinned installer requires Node.js 22.20.0 or newer; the read-only helpers require Node.js 20 or newer. This tag is installable and the companion branch is merged into main at b825360.
How it works
- Inspect the framework, package manager, FSD layers, and config.
- Map the request to a supported CLI structural operation.
- Preview uncertain work and protect existing slices.
- Run the CLI and inspect every generated or changed path.
- Implement the requested business logic and validate the result.
Example prompts
- “Create a cart feature.”
- “Add a product entity.”
- “Create a checkout page.”
- “Create a new Next.js project with Feature-Sliced Design.”
Verified scope
Version 2 adds progressive guides for discovery, domain decisions, feature implementation, architecture review, Supabase integration, incremental migration and rollback, verification, and releases. Framework guides cover React, Next.js, Vue, Nuxt, and SvelteKit. Three read-only helpers inventory projects, inspect import hints, and validate evidence reports.
Skill v2.0.0 predates CLI 2.7.0, so it still treats the batch, segment, custom-root, Supabase, and Steiger flags as candidate-only and asks for an explicitly selected candidate before using them. Those flags ship in CLI 2.7.0 and later, including the current 2.8.0. If the selected CLI cannot perform an operation, the agent keeps that limitation explicit and handles only the authorized manual implementation.
Validation: 15 helper/reference tests passed on Linux, macOS, and Windows with Node.js 20, 22, and 24. Four independent agent scenarios covered preserving an existing cart, reviewing Next.js without edits, gating unavailable Supabase flags, and domain placement. Broad provider behavior and live Supabase staging remain unverified.
Responsibility boundary
FSD CLI owns
Supported architecture, scaffolding, slice files, public APIs, route wrappers, project configuration, and managed upgrades.
The coding agent owns
Business logic, API integration, state behavior, forms, validation, domain rules, and unsupported manual changes.