🤖 repo2skill - Repository to Skill Converter

⚡ Convert any open-source repository into a comprehensive OpenCode/Claude Code Skill with one command

You found an amazing open-source project and want AI to help you understand and work with it, but faced these problems: Too much code for AI to read? Complicated configuration AI can't handle? Manual copy-paste exhausting?

repo2skill is here to solve these problems! It's like a "skill converter" that can transform any GitHub/GitLab/Gitee repository into a comprehensive skill package that AI assistants (OpenCode/Claude Code) can directly understand and use. You don't need to manually download code, configure complex environments, or provide API keys. Just provide a link, and it handles everything!

✨ Key Features

🎯 What It Does

• 🤖 AI-Powered Analysis: Uses your configured LLM in OpenCode/Claude Code to analyze repositories intelligently
• 🌐 Multi-Platform Support: Supports GitHub, GitLab, and Gitee - one tool for all
• 📁 Local Repository Support: Direct analysis of local project directories - no network required
• ⚡ Intelligent Mirror Rotation: Built-in 10+ GitHub mirrors with automatic failover and rate limit handling
• 📦 Zero Dependencies: No npm install, no API keys, no external packages - works out of the box
• 🔄 Batch Conversion: Convert multiple repositories simultaneously with parallel processing
• 📖 Complete Documentation: Generates comprehensive 18+ section skills covering installation, usage, API, FAQ, and more
• 🛡️ Smart Retry Logic: Exponential backoff (1s, 2s, 4s, 8s) with automatic mirror switching
• ✅ Ready to Use: Generated skills work immediately in OpenCode and Claude Code

⚡ Quick Start

Installation (30 seconds)

Simply copy the skill to your skills directory:

# Option 1: Global (recommended for all projects)
mkdir -p ~/.config/opencode/skills
cp -r repo2skill ~/.config/opencode/skills/

# Option 2: Claude-compatible
mkdir -p ~/.claude/skills
cp -r repo2skill ~/.claude/skills/

# Option 3: Project-specific
mkdir -p your-project/.opencode/skills
cp -r repo2skill your-project/.opencode/skills/

That's it! No npm install, no API keys needed. 🎉

Usage (One Command)

Start OpenCode or Claude Code and say:

帮我把这个仓库转成技能：https://github.com/vercel/next.js

OR for local projects:

帮我把当前项目转成技能

帮我把这个本地项目转成技能：./my-project

The skill will automatically:

1. ✅ Detect input type (remote URL or local path)
2. 🔍 Fetch/Extract data (from mirrors or local filesystem)
3. 📖 Use your configured LLM to analyze the repository
4. 📝 Generate a complete SKILL.md with 18+ sections
5. 💾 Ask you where to save the generated skill

🌐 Supported Platforms

GitHub ✅

Supported URLs:

• https://github.com/owner/repo
• https://www.github.com/owner/repo
• github.com/owner/repo (short form)

Features:

• 8 API mirrors with automatic rotation
• 5 Raw content mirrors
• 60 requests/hour without token, 5000/hour with token
• Comprehensive analysis of projects

Example:

帮我把这个 GitHub 仓库转成技能：https://github.com/anthropics/anthropic-sdk-typescript

GitLab ✅

Supported URLs:

• https://gitlab.com/owner/repo
• https://www.gitlab.com/owner/repo
• gitlab.com/owner/repo

Features:

• Official API + proxy support
• URL-encoded project paths
• ~60 requests/minute unauthenticated
• Full repository structure analysis

Example:

帮我把这个 GitLab 仓库转成技能：https://gitlab.com/gitlab-org/gitlab

Gitee ✅

Supported URLs:

• https://gitee.com/owner/repo
• https://www.gitee.com/owner/repo
• gitee.com/owner/repo

Features:

• Native Chinese platform - fast access in China
• No mirror rotation needed (native speed)
• API v5 support
• ~5000 requests/hour authenticated, ~100/hour unauthenticated

Example:

帮我把这个 Gitee 仓库转成技能：https://gitee.com/mindspore/docs

Local Repository ✅

Supported Paths:

• ./my-project (relative path)
• /home/user/projects/app (absolute path)
• ~/workspace/project (home directory)
• my-project (if directory exists in current path)

Features:

• Direct filesystem access - no network required
• 2-3x faster than remote repositories
• Automatic project type detection (JS, Python, Rust, Go, etc.)
• Smart metadata inference from config files
• Git remote URL detection (if git repository)

Example:

帮我把当前项目转成技能

帮我把这个本地项目转成技能：./my-frontend-app
帮我把这个目录转成技能：/home/user/projects/my-api-server

🛠️ How It Works

Architecture Overview

User Input (URL or Local Path)
       ↓
1. Input Detection
    ├─ Remote URL (github/gitlab/gitee.com) → Remote Flow
    └─ Local Path (./, /, ~, or directory) → Local Flow
       ↓
2a. Remote Repository Flow:
    - Parse Platform (GitHub/GitLab/Gitee)
    - Mirror Rotation API Calls
      · Metadata (stars, forks, language)
      · README content
      · File tree structure
      · Key documentation files
       ↓
2b. Local Repository Flow:
    - Path Validation
    - File Extraction (README, configs, docs)
    - Metadata Inference (language, type, deps)
    - Git Remote Detection (if applicable)
       ↓
3. AI Analysis (Your Configured LLM)
    - Project overview and features
    - Installation guides
    - Usage examples
    - API reference
    - Troubleshooting
       ↓
4. Generate SKILL.md
    - YAML frontmatter
    - 18+ comprehensive sections
    - Real-world examples
       ↓
5. Save to User-Selected Location
    - Project local
    - Global user config
    - Claude-compatible
       ↓
✅ Ready to Use!

Mirror Configuration

GitHub API Mirrors (priority order):

1. https://api.github.com (official)
2. https://gh.api.888888888.xyz
3. https://gh-proxy.com/api/github
4. https://api.fastgit.org
5. https://api.kgithub.com
6. https://githubapi.muicss.com
7. https://github.91chi.fun
8. https://mirror.ghproxy.com

GitHub Raw Mirrors:

1. https://raw.githubusercontent.com
2. https://raw.fastgit.org
3. https://raw.kgithub.com

Rate Limit Handling:

• Automatic mirror switching on 3 consecutive failures
• Exponential backoff: 1s, 2s, 4s, 8s
• Max 5 retries per endpoint
• 30-second request timeout

📚 Usage Examples

Example 1: Convert a Popular Framework

Input:

帮我把这个仓库转成技能：https://github.com/vercel/next.js

Output: A comprehensive Next.js skill (~400-600 lines) including:

• Installation guides (npm, yarn, pnpm)
• App Router and Pages Router
• Server Components and Client Components
• API Routes and Server Actions
• Image, Font, and Script optimization
• Testing and deployment
• FAQ and troubleshooting

Example 2: Batch Multiple Repositories

Input:

帮我转换这几个仓库:
- https://github.com/anthropics/anthropic-sdk-typescript
- https://gitlab.com/gitlab-org/gitlab
- https://gitee.com/mindspore/docs

Output: Parallel processing generates 3 complete skills in ~2-4 minutes.

Example 3: Convert a Small Library

Input:

帮我把这个工具库转成技能：https://github.com/user/my-utils

Output: Focused documentation (~200-300 lines) with:

• Usage examples
• API reference for all functions
• Quick start guide

Example 4: Chinese Repository

Input:

帮我把这个国内项目转成技能：https://gitee.com/mindspore/docs

Output: Bilingual skill preserving Chinese documentation with English translations.

Example 5: Local Project (New!)

Input:

帮我把当前项目转成技能

Output: Comprehensive local project skill analyzing your current directory:

• Automatic project type detection
• Installation and development setup
• Local build and test commands
• Project-specific architecture documentation
• Time: 10-30s (faster than remote!)
• No network required

Input:

帮我把这个本地项目转成技能：./my-frontend-app

Output: Complete frontend framework documentation including:

• Component structure and patterns
• State management setup
• Routing and navigation
• API integration patterns
• Build and deployment commands
• Local development workflow

📁 Project Structure

repo2skill/
├── repo2skill/                       # 🎯 Main Skill Directory (copy this to use)
│   ├── SKILL.md                      # Core system instructions (~596 lines, with local support)
│   ├── IMPLEMENTATION.md             # Technical documentation (~240 lines)
│   ├── references/                   # API reference documentation
│   │   ├── github-api.md             # GitHub API quick reference (123 lines)
│   │   ├── gitlab-api.md             # GitLab API quick reference (114 lines)
│   │   └── gitee-api.md              # Gitee API quick reference (31 lines)
│   └── scripts/                      # Utility scripts
│       └── utils.sh                  # Bash helper functions (~160 lines, with local support)
├── README.md                         # This file
├── README_EN.md                      # English version
├── README_ZH.md                      # Chinese version
├── INSTALL.md                        # Installation guide
├── QUICKSTART.md                     # 5-minute quick start
├── EXAMPLES.md