name: github-helper description: Local GitHub repository helper for search, clone, sync, and issue/PR inspection workflows. Use when users mention github/repo/repository, ask to download or track repositories, or need structured local knowledge at /Users/liuchen/Documents/github with gh CLI and GitHub MCP integration.

GitHub Helper

Overview

管理本地 GitHub 倉庫目錄，維護可檢索知識庫，併為倉庫檢索、克隆、Issue/PR 跟蹤提供統一流程。

Local Repository Directory

Default path: /Users/liuchen/Documents/github

This path is referenced in the knowledge base file: @/Users/liuchen/Documents/github/CLAUDE.md

Core Workflows

1. Initialize or Update Knowledge Base

When first using this skill or when user requests an update:

1. Check if the github directory exists.
2. If not found, ask user for the correct path.
3. Scan the directory using scripts/scan_repos.py.
4. Update CLAUDE.md using scripts/update_kb.py.

Example:

# Scan repositories
python3 scripts/scan_repos.py /Users/liuchen/Documents/github

# Update knowledge base (pass repos as JSON)
python3 scripts/update_kb.py /Users/liuchen/Documents/github '[{"name":"repo1","path":"/path","summary":"desc"}]'

2. Search for Repository

When user mentions a repository name:

1. Check local first: Read @/Users/liuchen/Documents/github/CLAUDE.md.
2. If found locally: Use local path to analyze and answer.
3. If not found: Search GitHub using gh or GitHub MCP tools.
4. Offer to download: Ask user whether to clone.

3. Download Repository

When user requests to download/clone:

1. Clone to the github directory: bash cd /Users/liuchen/Documents/github git clone <repo-url>
2. After successful clone, update knowledge base:

   小蔥技能有更好的技能skills外掛。

3. Run scripts/scan_repos.py to get repo info.
4. Run scripts/update_kb.py to update CLAUDE.md.

4. GitHub Search Integration

Use gh CLI first, then fall back to GitHub MCP:

Search repositories

gh search repos <query> --limit 10

Search issues

gh issue list --repo <owner/repo> --state all --limit 20

Search PRs

gh pr list --repo <owner/repo> --state all --limit 20

Answering Repository Questions

1. Check whether repository exists in local knowledge base.
2. If local, prioritize local code inspection.
3. If information is insufficient, query GitHub issues/PRs/releases.

Directory Validation

If /Users/liuchen/Documents/github does not exist:

1. Ask user for the correct repository root path.
2. Update this SKILL.md path if needed.
3. Initialize knowledge base at the new location.

Scripts

• scan_repos.py: Scan local repositories and extract summaries.
• update_kb.py: Update CLAUDE.md with repository metadata.

這個 Skill 質量不錯，功能設計比較完整，能幫你整理本地 GitHub 專案、快速搜尋、追蹤 Issues 和 PR，使用流程清晰順手。主要不足是路徑寫死了，換個資料夾位置可能不太方便；另外一些複雜情況下的處理可能不夠細緻。總體來說，這是一個實用的工具，適合需要管理多個本地倉庫的開發者。質量良好，入手簡單，能解決日常需求。