Skip to main content
subagent CX Codex

skill-generator-agent — Claude Code subagent: what it does

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

no license ★ 1,357 updated 2026-03-01

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/skill-generator-agent.md
Open on GitHub

What skill-generator-agent 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.

What it helps with

  • 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 for the agent

  • 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

How to install skill-generator-agent

Manually: put the files in place

.claude/agents/skill-generator-agent.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about skill-generator-agent

How do I install skill-generator-agent in Claude Code?

Copy the agent file to .claude/agents/skill-generator-agent.md.

What does skill-generator-agent do?

It builds a skill from a spec: the main SKILL.md, reference docs, examples and scripts arranged in folders. Then it runs checks on frontmatter and structure.

What do I need before running it?

A finished spec from skill-elicitation-agent, which supplies the name, triggers and file list. Access to Write and Bash matters too, since nothing reaches disk without them.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set112

The whole set →
decision-navigator decision-navigator structures complex choices, scores trade-offs, and quantifies risk factors. Useful when you need to assess the reversibility and consequences of technical plans. CX Codex ★ 1,357repo stars dependency-mapper The dependency-mapper command connects code dependencies, Linear tasks, and Git history into project maps. Use it to spot cycles, blockers, and task order. CX Codex +1 ★ 1,357repo stars test-engineer test-engineer writes unit, integration and end-to-end tests for the code you just finished, then reports coverage by line, branch and function. Useful when a feature works but nothing guards it. CX Codex ★ 1,357repo stars audit-layer-boundaries audit-layer-boundaries analyzes architectural layer boundaries in Rust projects. It catches mixed responsibilities, misplaced database logic, and boundary leaks. CX Codex +1 ★ 1,357repo stars milestone-tracker milestone-tracker aggregates milestone data from Linear, GitHub, and git history to calculate burn-down velocity and spot schedule risks. CX Codex +1 ★ 1,357repo stars audit-dependencies audit-dependencies audits dependency direction in Rust projects and flags layer violations. Use it when reviewing architecture or preparing a refactor. CX Codex +1 ★ 1,357repo stars build-skill build-skill walks a new Claude skill through four agents: requirement questions, file generation, validation, docs. You approve the spec before any file appears. CX Codex +1 ★ 1,357repo stars spec-elicitation spec-elicitation conducts a rigorous interview to turn rough feature concepts into detailed technical specifications before writing code. CX Codex +1 ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open