skill-creation — Claude Code skill: what it does, how to install
skill-creation converts past session breakthroughs into reusable agent skills inside SKILL.md files. Helps extract repeatable patterns and refine existing instructions.
no license 142 installs ★ 129 updated 2026-10-25
npx skills add Factory-AI/factory-plugins --skill skill-creation -a claude-codeWhat skill-creation does
The skill captures successful problem-solving paths from agent sessions and turns them into standalone SKILL.md documents. Each file starts with YAML metadata containing its name and trigger criteria. A precise description is critical here because the agent relies on it when picking which skill to trigger for an incoming prompt.
Skills are organized on two levels. Shared project playbooks go into .factory/skills/ and get checked into version control. User-specific workflows stay in ~/.factory/skills/. The skill prompts you to include verification steps and explicit failure boundaries. Without automated verification checks, an agent cannot validate its own output.
To spot recurring bottlenecks, you can inspect JSONL session archives with rg. Breaking changes to inputs or outputs warrant a major version increment.
What it helps with
- extract solved session problems into reusable
SKILL.mdguides - locate recurring errors across JSONL session logs with
rg - establish project-wide conventions inside
.factory/skills/ - revise outdated agent instructions with new version tags
Example prompts for the agent
- Extract the debugging steps from this session into a fresh skill
- Update the deployment skill with verification steps and common edge cases
- Inspect recent session logs to find repeated failures and improve the skill
How to install skill-creation
1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill skill-creation -a claude-code2Manually: put the files in place
~/.claude/skills/skill-creation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-creation/
1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill skill-creation -a codex2Manually: put the files in place
.agents/skills/skill-creation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill skill-creation -a cursor2Manually: put the files in place
.cursor/skills/skill-creation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Factory-AI/factory-plugins plugins/droid-evolved/skills/skill-creation2Manually: put the files in place
.github/skills/skill-creation/SKILL.md1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill skill-creation -a gemini-cli2Platform CLI
gemini skills install https://github.com/Factory-AI/factory-plugins --path plugins/droid-evolved/skills/skill-creationManually: put the files in place
.devin/skills/skill-creation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill skill-creation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skill-creation
How do I install skill-creation in Claude Code?
Run npx skills add Factory-AI/factory-plugins --skill skill-creation -a claude-code in your terminal.
What does the skill-creation skill do?
It guides you in turning ad-hoc session fixes into structured SKILL.md files with clear triggers, failure notes, and verification routines.
Where are skills stored?
Project skills live in .factory/skills/ so teammates can track them in git. Personal skills reside in ~/.factory/skills/ for cross-project use.