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.

What it does

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.

Prerequisites

- Node.js >= 18
- git - to clone repositories

Installation

$3

``bash
npx create-agent-skill https://github.com/solidjs/solid
`

$3

`bash
npm install -g create-agent-skill
`

Usage

`
create-agent-skill [options]
`

| 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.

$3

`bash


Auto-detect installed agents (interactive selection)

npx create-agent-skill https://github.com/solidjs/solid

Target specific agents

npx create-agent-skill https://github.com/solidjs/solid -a claude-code -a cursor

Install for all agents globally

npx create-agent-skill https://github.com/withastro/astro --global --all-agents

From a local repository

npx create-agent-skill ./my-local-repo -a claude-code
npx create-agent-skill /path/to/cloned/repo --global -a cursor -a gemini-cli
`

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.

License

This project is licensed under the MIT License.