create-skill

Installation
SKILL.md

Create Skill

Bootstrap a new agent skill, then symlink it into .claude/skills/ so Claude Code can discover it. Default to splitting bulk content into references/ and scripts/ so SKILL.md stays lean.

Arguments

  • skill-name (required): kebab-case name (e.g., my-skill). Stop if missing or invalid.
  • --global (optional): install under ~ instead of the current repo.

Resolved Paths

Mode Skill source Claude Code symlink
local (default) .agents/skills/<name>/ .claude/skills/<name>
--global ~/.agents/skills/<name>/ ~/.claude/skills/<name>

The symlink target is always the relative path ../../.agents/skills/<name> so it resolves correctly in both scopes.

Skill Layout

Related skills

More from paulrberg/agent-skills

Installs
22
GitHub Stars
54
First Seen
Apr 16, 2026