Skip to content

Applies to CLI v2.8.0

Agent Skills

Stable v2.0.0

Use 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

bash
npx skills@1.7.0 add https://github.com/FSD-CLI/create-fsd-architecture/tree/v2.0.0/skills/fsd-cli --skill fsd-cli

The 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

  1. Inspect the framework, package manager, FSD layers, and config.
  2. Map the request to a supported CLI structural operation.
  3. Preview uncertain work and protect existing slices.
  4. Run the CLI and inspect every generated or changed path.
  5. 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.

Support FSD CLI

If FSD CLI helps you build, consider supporting its development and documentation. Donations are optional.

GitHub Sponsors (opens in a new tab)Buy Me a Coffee (opens in a new tab)

InstaPay · Egypt

ashrafmo-1

للدعم من مصر عبر إنستا باي. تأكد من بيانات المستلم قبل تأكيد التحويل.