Quick Start

# Install globally
npm install -g repo2skill

# Run
repo2skill https://github.com/facebook/react

Or use without installing:

npx repo2skill https://github.com/facebook/react

✅ Skill generated: ./skills/react/
   SKILL.md: ./skills/react/SKILL.md
   References: 3 file(s)
   Quality: 85/100 ████████████████░░░░ Good

That's it. Your agent can now use React.

What It Does

repo2skill reads a GitHub repo — README, package manifests, source code, project structure — and generates a complete AgentSkills SKILL.md with description, triggers, usage examples, and reference files.

No LLM required. Pure heuristic analysis. Fast, deterministic, offline-capable.

20+ Languages Supported

| Language | Package File | Language | Package File | |---|---|---|---| | TypeScript | package.json | Ruby | Gemfile | | Python | pyproject.toml | PHP | composer.json | | Rust | Cargo.toml | Elixir | mix.exs | | Go | go.mod | Dart | pubspec.yaml | | Java | pom.xml | Scala | build.sbt | | C# | *.csproj | Haskell | *.cabal | | Swift | Package.swift | Lua | *.rockspec | | Kotlin | build.gradle.kts | Zig | build.zig | | C/C++ | CMakeLists.txt | R | DESCRIPTION |

Features

🧠 AI-Enhanced (Optional)

repo2skill facebook/react --ai
# LLM-powered description improvement (needs OPENAI_API_KEY)

📦 ClawHub Publish

repo2skill facebook/react --publish
# Generate + publish to ClawHub in one step

🔍 Framework Detection

Automatically identifies: MCP servers, AI agents, web frameworks, CLI tools, serverless functions, libraries.

📊 Quality Reports

repo2skill quality-report ./skills/ -o report.html
# Quality: 85/100 — description ✅, examples ✅, features ✅, API docs ⚠️

📁 Monorepo Support

repo2skill monorepo ./my-monorepo
# Detected 5 packages (npm-workspaces)
# Generates per-package skills

⚡ Batch Processing

repo2skill --batch repos.txt --parallel 3 --min-quality 60

🔄 Diff & Compare

repo2skill compare expressjs/express fastify/fastify
repo2skill diff old-skill.md new-skill.md

Use Cases

🤖 Skill Library Building — Bulk-convert popular repos into agent skills for your team.

🔄 CI/CD Integration — Auto-regenerate skills when upstream repos update.

📋 Repo Auditing — Quality-score any repo's documentation completeness.

🏗️ Monorepo Management — Generate per-package skills for large codebases.

📊 Comparison — Side-by-side analysis of competing libraries.

CLI Reference

# From GitHub
repo2skill facebook/react

# From local directory
repo2skill --local ./my-project

# Dry run
repo2skill --dry-run openai/openai-node

# JSON output
repo2skill --json openai/openai-node

# Custom template
repo2skill facebook/react --template security

# Subcommands
repo2skill validate ./skills/react/SKILL.md
repo2skill lint ./skills/react/SKILL.md
repo2skill health ./skills/react/SKILL.md
repo2skill compare repo-a repo-b
repo2skill changelog facebook/react
repo2skill graph ./skills/ -o graph.html
repo2skill template --type cli --name my-tool

Full reference: see repo2skill --help

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT © Kang Zhou