Turn any GitHub repo into an AI agent skill
One command. Any repo. Ready-to-use SKILL.md.
# Install globally
npm install -g repo2skill
# Run
repo2skill https://github.com/facebook/reactOr 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.
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.
| 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 |
repo2skill facebook/react --ai
# LLM-powered description improvement (needs OPENAI_API_KEY)repo2skill facebook/react --publish
# Generate + publish to ClawHub in one stepAutomatically identifies: MCP servers, AI agents, web frameworks, CLI tools, serverless functions, libraries.
repo2skill quality-report ./skills/ -o report.html
# Quality: 85/100 — description ✅, examples ✅, features ✅, API docs ⚠️repo2skill facebook/react --security
# 🔒 Security Report — Risk Level: 🟢 LOW, 0 findings
repo2skill security ./my-project
# Standalone scan without generating a skillrepo2skill monorepo ./my-monorepo
# Detected 5 packages (npm-workspaces)
# Generates per-package skillsrepo2skill --batch repos.txt --parallel 3 --min-quality 60repo2skill compare expressjs/express fastify/fastify
repo2skill diff old-skill.md new-skill.md🤖 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.
# 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-toolFull reference: see repo2skill --help and docs/API.md
See CONTRIBUTING.md for guidelines.
MIT © NeuZhou
Made with 🦀 by NeuZhou
repo2skill is part of the NeuZhou open source toolkit for AI agents:
| Project | What it does | Link |
|---|---|---|
| repo2skill | Convert any repo into an AI agent skill | You are here |
| ClawGuard | Security scanner for AI agents | GitHub |
| AgentProbe | Behavioral testing framework for agents | GitHub |
| FinClaw | AI-powered financial intelligence engine | GitHub |
The workflow: Generate skills with repo2skill → Scan for vulnerabilities with ClawGuard → Test behavior with AgentProbe → See it in action with FinClaw.