🔧 repo2skill

Turn any GitHub repo into an AI agent skill

One command. Any repo. Ready-to-use SKILL.md.

---

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

---

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 ⚠️

🔒 Security Scanning

repo2skill facebook/react --security
# 🔒 Security Report — Risk Level: 🟢 LOW, 0 findings

repo2skill security ./my-project
# Standalone scan without generating a skill

📁 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 and docs/API.md

---

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT © NeuZhou

---

Made with 🦀 by NeuZhou

🔗 NeuZhou Ecosystem

repo2skill is part of the NeuZhou open source toolkit for AI agents:

The workflow: Generate skills with repo2skill → Scan for vulnerabilities with ClawGuard → Test behavior with AgentProbe → See it in action with FinClaw.