{"id":"22e3ea6e-8a0b-4cc4-9c58-03a3e0d6f0c2","shortId":"gktEq2","kind":"skill","title":"create-skill","tagline":"This skill should be used when the user asks to \"create a skill\", \"new skill\", \"scaffold a skill\", \"make a skill\", \"init a skill\", or wants to bootstrap a new agent skill in `.agents/skills` (default) or `~/.agents/skills` (with `--global`).","description":"# Create Skill\n\nBootstrap a new agent skill, then symlink it into `.claude/skills/` so Claude Code can discover it.\n\n## Arguments\n\n- **skill-name** (required): kebab-case name (e.g., `my-skill`). Stop if missing or invalid.\n- `--global` (optional): install under `~` instead of the current repo.\n\n## Resolved Paths\n\n| Mode              | Skill source                | Claude Code symlink             |\n| ----------------- | --------------------------- | ------------------------------- |\n| local (default)   | `.agents/skills/<name>/`    | `.claude/skills/<name>`         |\n| `--global`        | `~/.agents/skills/<name>/`  | `~/.claude/skills/<name>`       |\n\nThe symlink target is always the relative path `../../.agents/skills/<name>` so it resolves correctly in both scopes.\n\n## Workflow\n\n### 1. Fetch Agent Skills Docs\n\nAlways fetch the latest spec before authoring frontmatter or content:\n\n- https://agentskills.io\n\nUse `WebFetch` to confirm the current SKILL.md frontmatter schema, naming rules, and conventions. Do not guess — the spec evolves.\n\n### 2. Validate\n\n- Reject names that are not kebab-case or collide with an existing skill at the resolved path.\n- Stop if `<scope>/.agents/skills/<name>/` or `<scope>/.claude/skills/<name>` already exists.\n\n### 3. Create the Skill\n\n```bash\nmkdir -p \"<scope>/.agents/skills/<name>\"\n```\n\nWrite `<scope>/.agents/skills/<name>/SKILL.md` with:\n\n- Frontmatter sorted alphabetically, with `description` last.\n- A short `# Title`.\n- A one-line summary of what the skill does.\n- `## Arguments` (if any) and `## Workflow` sections with concrete steps.\n\nKeep it minimal. Add `scripts/` or `references/` subdirectories only if the workflow needs them.\n\n### 4. Create the Claude Code Symlink\n\nAlways create a relative symlink so Claude Code picks the skill up from its own discovery path:\n\n```bash\nmkdir -p \"<scope>/.claude/skills\"\nln -s \"../../.agents/skills/<name>\" \"<scope>/.claude/skills/<name>\"\n```\n\n### 5. Verify\n\n- `test -f \"<scope>/.agents/skills/<name>/SKILL.md\"`\n- `readlink \"<scope>/.claude/skills/<name>\"` resolves to the source directory.\n- Print both absolute paths to the user.\n\n## Notes\n\n- Frontmatter rule: sort fields alphabetically, but always place `description` last.\n- Bash scripts inside the skill should be compatible with Bash 3.2 (Codex's default shell).\n- Do not commit the new skill — leave that to the user.","tags":["create","skill","agent","skills","paulrberg","agent-skills","ai-agents"],"capabilities":["skill","source-paulrberg","skill-create-skill","topic-agent-skills","topic-ai-agents"],"categories":["agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/PaulRBerg/agent-skills/create-skill","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add PaulRBerg/agent-skills","source_repo":"https://github.com/PaulRBerg/agent-skills","install_from":"skills.sh"}},"qualityScore":"0.475","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 50 github stars · SKILL.md body (2,377 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T00:56:18.057Z","embedding":null,"createdAt":"2026-04-18T22:17:41.655Z","updatedAt":"2026-04-22T00:56:18.057Z","lastSeenAt":"2026-04-22T00:56:18.057Z","tsv":"'/../.agents/skills':111,265 '/.agents/skills':40,101,177,189,191,271 '/.claude/skills':102,179,262,266,274 '/skill.md':192,272 '1':120 '2':155 '3':182 '3.2':308 '4':236 '5':267 'absolut':282 'add':225 'agent':34,48,122 'agents/skills':37,98 'agentskills.io':135 'alphabet':196,292 'alreadi':180 'alway':107,125,242,294 'argument':61,213 'ask':12 'author':131 'bash':186,259,298,307 'bootstrap':31,45 'case':68,164 'claud':56,93,239,248 'claude/skills':54,99 'code':57,94,240,249 'codex':309 'collid':166 'commit':315 'compat':305 'concret':220 'confirm':139 'content':134 'convent':148 'correct':115 'creat':2,14,43,183,237,243 'create-skil':1 'current':86,141 'default':38,97,311 'descript':198,296 'directori':279 'discov':59 'discoveri':257 'doc':124 'e.g':70 'evolv':154 'exist':169,181 'f':270 'fetch':121,126 'field':291 'frontmatt':132,143,194,288 'global':42,79,100 'guess':151 'init':25 'insid':300 'instal':81 'instead':83 'invalid':78 'kebab':67,163 'kebab-cas':66,162 'keep':222 'last':199,297 'latest':128 'leav':319 'line':206 'ln':263 'local':96 'make':22 'minim':224 'miss':76 'mkdir':187,260 'mode':90 'my-skil':71 'name':64,69,145,158 'need':234 'new':17,33,47,317 'note':287 'one':205 'one-lin':204 'option':80 'p':188,261 'path':89,110,174,258,283 'pick':250 'place':295 'print':280 'readlink':273 'refer':228 'reject':157 'relat':109,245 'repo':87 'requir':65 'resolv':88,114,173,275 'rule':146,289 'scaffold':19 'schema':144 'scope':118 'script':226,299 'section':218 'shell':312 'short':201 'skill':3,5,16,18,21,24,27,35,44,49,63,73,91,123,170,185,211,252,302,318 'skill-create-skill' 'skill-nam':62 'skill.md':142 'sort':195,290 'sourc':92,278 'source-paulrberg' 'spec':129,153 'step':221 'stop':74,175 'subdirectori':229 'summari':207 'symlink':51,95,104,241,246 'target':105 'test':269 'titl':202 'topic-agent-skills' 'topic-ai-agents' 'use':8,136 'user':11,286,323 'valid':156 'verifi':268 'want':29 'webfetch':137 'workflow':119,217,233 'write':190","prices":[{"id":"a856553a-b8ca-496a-b4d3-654ef4fc7518","listingId":"22e3ea6e-8a0b-4cc4-9c58-03a3e0d6f0c2","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"PaulRBerg","category":"agent-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:17:41.655Z"}],"sources":[{"listingId":"22e3ea6e-8a0b-4cc4-9c58-03a3e0d6f0c2","source":"github","sourceId":"PaulRBerg/agent-skills/create-skill","sourceUrl":"https://github.com/PaulRBerg/agent-skills/tree/main/skills/create-skill","isPrimary":false,"firstSeenAt":"2026-04-18T22:17:41.655Z","lastSeenAt":"2026-04-22T00:56:18.057Z"}],"details":{"listingId":"22e3ea6e-8a0b-4cc4-9c58-03a3e0d6f0c2","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"PaulRBerg","slug":"create-skill","github":{"repo":"PaulRBerg/agent-skills","stars":50,"topics":["agent-skills","ai-agents"],"license":"mit","html_url":"https://github.com/PaulRBerg/agent-skills","pushed_at":"2026-04-20T16:22:56Z","description":"PRB's collection of agent skills","skill_md_sha":"4bb4aa9dd94d3a1d29fc898f81a33870a27f87df","skill_md_path":"skills/create-skill/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/PaulRBerg/agent-skills/tree/main/skills/create-skill"},"layout":"multi","source":"github","category":"agent-skills","frontmatter":{"name":"create-skill","description":"This skill should be used when the user asks to \"create a skill\", \"new skill\", \"scaffold a skill\", \"make a skill\", \"init a skill\", or wants to bootstrap a new agent skill in `.agents/skills` (default) or `~/.agents/skills` (with `--global`)."},"skills_sh_url":"https://skills.sh/PaulRBerg/agent-skills/create-skill"},"updatedAt":"2026-04-22T00:56:18.057Z"}}