# skill-generator-agent

skill-generator-agent turns a skill spec into files on disk: SKILL.md, helper scripts, reference docs. Then it checks frontmatter and layout.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/skill-builder/skill-generator-agent.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/skill-generator-agent

## What it does

Give it a specification and it writes the skill out: a `SKILL.md` with proper frontmatter, supporting material in its own folders, plus scripts with execute permission set where the spec asks for them. The run is ordered — read the spec, plan the layout, generate, then verify.

Folders follow your answer about placement: personal skills go under `~/.claude/skills/skill-name/`, project ones under `.claude/skills/skill-name/`. Inside, `scripts/` holds runnable code, `references/` holds longer docs, `assets/` holds templates. Before finishing it checks the YAML, the trigger wording in description, and that every planned file is there.

The spec has to exist first. This agent works from the document produced by `skill-elicitation-agent` and has nothing to build without it. Its toolset includes `Write` and `Bash`, so files really land on disk.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/skill-generator-agent.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/skill-generator-agent.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/skill-generator-agent.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/skill-builder/skill-generator-agent.md

## When to use it
- turn a written spec into a valid `SKILL.md`
- lay out a multi-file skill across `scripts/`, `references/` and `assets/`
- generate a helper script with error handling and usage notes
- audit a skill before publishing: YAML, triggers, file permissions
- decide between a personal and a project path for a new skill

## Example prompts
- Build the skill from `spec.md` and put it under `.claude/skills/`
- Generate `SKILL.md` and `reference.md` for a log-parsing skill, with triggers in the frontmatter
- Check the layout of `~/.claude/skills/pdf-helper/` and tighten its description

## Similar
- [nx-generate](https://affpapa.org/en/nevibecode/skills/nx-generate.md) — skill · 4000 installs
- [conformetry-generate](https://affpapa.org/en/nevibecode/skills/conformetry-generate.md) — skill · 672 installs
- [stitch::generate-design](https://affpapa.org/en/nevibecode/skills/stitchgenerate-design.md) — skill · 12500 installs
- [testing-handbook-generator](https://affpapa.org/en/nevibecode/skills/testing-handbook-generator.md) — skill · 5800 installs
- [cue-kind-definition](https://affpapa.org/en/nevibecode/skills/cue-kind-definition.md) — skill · 4600 installs
- [app-sdk-concepts](https://affpapa.org/en/nevibecode/skills/app-sdk-concepts.md) — skill · 4600 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
