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

Use directly with npx (no install needed)

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

Install globally

npm install -g create-agent-skill

Usage

create-agent-skill <github-url|local-path> [options]

| Option | Description | |--------|-------------| | --local | Install for current project (default) | | --global | Install globally (~/.agents/skills/) | | -a, --agent <id> | 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.

Examples

# 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-name>/
  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/<skill-name>/      -> ../../.agents/skills/<skill-name>
.cursor/skills/<skill-name>/      -> ../../.agents/skills/<skill-name>
.codex/skills/<skill-name>/       -> ../../.agents/skills/<skill-name>
(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.