How do I install the Specification Generator skill?

Run npx skillmds@latest add gabrielmoreira/specification-generator in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Specification Generator safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Specification Generator?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Specification Generator free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Specification Generator?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Specification Generator by gabrielmoreira

Name: Specification Generator
Rating: 4.666666666666667 (3 reviews)
Author: gabrielmoreira

File contents

Skill: AI Agent Specification Generator

This skill guides the AI assistant in creating, modifying, and compiling new developer specification files (rules, agents, commands, or skills) within the unified directory structure.

Scaffolding Tool Usage

When asked by the user to add or bootstrap a specification, run the custom scaffolding script from the workspace root rather than writing directories manually. This ensures that proper YAML frontmatter and file structures are established.

npm --prefix specification-scripts run spec:create -- --type <type> --domain <domain> --name <name> --description "<description>"

Parameters

--type: One of rule, agent, command, skill
--domain: One of common, typescript, frontend, backend, database, testing, deployment
--name: kebab-case identifier (e.g. query-caching or a11y-contrast)
--description: A short description summarizing the purpose of the specification

Directory Mapping

The tool generates file targets under specifications/ according to the following category/type scheme:

Specification Type	Folder Path under `specifications/<domain>/`	Compiled Copilot Target	Compiled Claude Target
rule	`rules/<name>.md`	`.github/instructions/<name>.instructions.md`	`.claude/rules/<name>.md`
agent	`agents/<name>.md`	`.github/agents/<name>.agent.md`	`.claude/agents/<name>.md`
command	`commands/<name>.md`	`.github/prompts/<name>.prompt.md`	`.claude/commands/<name>.md`
skill	`skills/<name>/SKILL.md`	`.github/skills/<name>/SKILL.md`	`.claude/skills/<name>/SKILL.md`

Code Synchronization

The scaffolding tool automatically calls the synchronization engine on success. If you make manual updates to a file inside the specifications/ directory, you must immediately trigger compilation to propagate the updates to the platform-specific folders:

npm --prefix specification-scripts run spec:sync

[!WARNING] Never write or edit files directly inside the .github/ or .claude/ directories. Any direct edits will be overwritten the next time a sync command is executed.

---name: specification-generatordescription: Skill workflow for creating and synchronizing AI agent specifications (rules, agents, commands, or skills) in the specifications/ directory.--- # Skill: AI Agent Specification Generator This skill guides the AI assistant in creating, modifying, and compiling new developer specification files (rules, agents, commands, or skills) within the unified directory structure. ## Scaffolding Tool Usage When asked by the user to add or bootstrap a specification, run the custom scaffolding script from the workspace root rather than writing directories manually. This ensures that proper YAML frontmatter and file structures are established. ```bash npm --prefix specification-scripts run spec:create -- --type <type> --domain <domain> --name <name> --description "<description>" ``` ### Parameters - `--type`: One of `rule`, `agent`, `command`, `skill` - `--domain`: One of `common`, `typescript`, `frontend`, `backend`, `database`, `testing`, `deployment` - `--name`: kebab-case identifier (e.g. `query-caching` or `a11y-contrast`) - `--description`: A short description summarizing the purpose of the specification ## Directory Mapping The tool generates file targets under `specifications/` according to the following category/type scheme: | Specification Type | Folder Path under `specifications/<domain>/` | Compiled Copilot Target | Compiled Claude Target | |---|---|---|---| | **rule** | `rules/<name>.md` | `.github/instructions/<name>.instructions.md` | `.claude/rules/<name>.md` | | **agent** | `agents/<name>.md` | `.github/agents/<name>.agent.md` | `.claude/agents/<name>.md` | | **command** | `commands/<name>.md` | `.github/prompts/<name>.prompt.md` | `.claude/commands/<name>.md` | | **skill** | `skills/<name>/SKILL.md` | `.github/skills/<name>/SKILL.md` | `.claude/skills/<name>/SKILL.md` | ## Code Synchronization The scaffolding tool automatically calls the synchronization engine on success. If you make manual updates to a file inside the `specifications/` directory, you **must** immediately trigger compilation to propagate the updates to the platform-specific folders: ```bash npm --prefix specification-scripts run spec:sync ``` > [!WARNING] > Never write or edit files directly inside the `.github/` or `.claude/` directories. Any direct edits will be overwritten the next time a sync command is executed.

Frequently asked questions

Specification Generator