Create an agent skill from any GitHub repository — supports 30 agents
npm install create-agent-skill

A CLI tool that turns any GitHub repository into an agent skill, compatible with the Agent Skills ecosystem. Supports 30 agents including Claude Code, Cursor, Codex, Copilot, Gemini CLI, and more.
Works on macOS, Linux, and Windows.
create-agent-skill takes a GitHub repository (or a local clone) and generates a structured agent skill from it. The skill includes extracted documentation, TypeScript type definitions, and code examples. It installs the skill in a canonical .agents/skills/ directory and creates symlinks into each selected agent's skills directory.
- Node.js >= 18
- git - to clone repositories
``bash`
npx create-agent-skill https://github.com/solidjs/solid
`bash`
npm install -g create-agent-skill
``
create-agent-skill
| Option | Description |
|--------|-------------|
| --local | Install for current project (default) |--global
| | Install globally (~/.agents/skills/) |-a, --agent
| | Target a specific agent (repeatable) |--all-agents
| | Install for all 30 known agents |-h, --help
| | Show help |
If no -a flag is provided, installed agents are auto-detected and you are prompted to select which ones to target.
`bashAuto-detect installed agents (interactive selection)
npx create-agent-skill https://github.com/solidjs/solid
Supported agents
| ID | Name |
|----|------|
|
amp | Amp |
| antigravity | Antigravity |
| claude-code | Claude Code |
| clawdbot | Clawdbot |
| cline | Cline |
| codebuddy | CodeBuddy |
| codex | Codex |
| command-code | Command Code |
| continue | Continue |
| crush | Crush |
| cursor | Cursor |
| droid | Droid |
| gemini-cli | Gemini CLI |
| github-copilot | GitHub Copilot |
| goose | Goose |
| kilo | Kilo Code |
| kiro-cli | Kiro CLI |
| mcpjam | MCPJam |
| mux | Mux |
| opencode | OpenCode |
| openhands | OpenHands |
| pi | Pi |
| qoder | Qoder |
| qwen-code | Qwen Code |
| roo | Roo Code |
| trae | Trae |
| windsurf | Windsurf |
| zencoder | Zencoder |
| neovate | Neovate |How it works
1. Clone or read in-place - The repository is shallow-cloned into a temporary directory, or read directly in-place if local.
2. Detect project type - Identifies the project type (Node.js, Rust, Go, Python) from manifest files.
3. Extract documentation - All Markdown/MDX files are collected into
references/docs.md.
4. Extract types - For Node.js projects, .d.ts files are collected into references/types.md.
5. Extract examples - Code files from examples/, demo/, or samples/ directories are collected into references/examples.md.
6. Generate SKILL.md - A skill manifest is created with metadata, instructions, and links to the reference files.
7. Install - The skill is placed in the canonical .agents/skills/ directory, then symlinks are created in each selected agent's skills directory. Falls back to copying on systems where symlinks are not available.
8. Cleanup - The temporary directory is removed.Generated output structure
`
Canonical location (real files)
.agents/skills//
SKILL.md # Skill manifest and instructions
references/
docs.md # Aggregated documentation
types.md # TypeScript definitions (Node.js projects)
examples.md # Code examples (if found)Agent symlinks (point to canonical)
.claude/skills// -> ../../.agents/skills/
.cursor/skills// -> ../../.agents/skills/
.codex/skills// -> ../../.agents/skills/
(etc. for each selected agent)
`Global installs use
~/.agents/skills/ as the canonical location, with symlinks in each agent's global skills directory (e.g. ~/.claude/skills/, ~/.cursor/skills/).Supported project types
| Type | Detected by | Extra extraction |
|------|-------------|-----------------|
| Node.js |
package.json | .d.ts type definitions, package.json metadata |
| Rust | Cargo.toml | -- |
| Go | go.mod | -- |
| Python | pyproject.toml or setup.py | -- |Compatibility
Compatible with the Agent Skills ecosystem (
npx skills). Skills created by create-agent-skill` follow the same directory conventions and SKILL.md format.This project is licensed under the MIT License.