agentleFS
0xtootoo290xtootoo29/tootoo-skills/github-kb/SKILL.md

github-kb

Skill0 starsChanged 9 months agoMITView on GitHub

name: github-kb description: 管理本地 GitHub 知识库(~/github-kb/)。当用户提到 clone 仓库、搜索 GitHub 项目、查看 repo/PR/issue、研究开源项目、部署开源工具时使用此技能。支持通过 gh CLI 搜索 GitHub,并维护 CLAUDE.md 项目目录。 Manage a local GitHub knowledge base at ~/github-kb/ and provide GitHub search capabilities via gh CLI. Key file: CLAUDE.md at the root of the KB directory catalogs all projects with brief descriptions. 核心思路:把 clone 下来的代码仓库当作 AI 的知识库,直接读源码回答问题,而不是让用户自己去读文档。 When user asks to find or search for GitHub repositories: Search qualifiers: When user asks to find or search for GitHub issues: Search qualifiers: When user…

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. sdwurg180507280211/my-skills★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repositoryOne other file it gives its agents.

The file

We split this skill into the rules it gives an agent

10 rules. About 0 are common, 9 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈9

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When user asks to find or search for GitHub repositories:

    line 23
  2. Distinctive:

    When user asks to find or search for GitHub issues:

    line 45
  3. Distinctive:

    When user asks to find or search for pull requests:

    line 68
  4. Distinctive:

    After finding a PR or issue, view details:

    line 91
  5. Distinctive:

    Before using this skill, initialize the knowledge base directory:

    line 119
  6. Distinctive:

    When user asks about a specific repository or project in the KB:

    line 132
  7. Distinctive:

    When user requests to clone a repository (e.g., "clone anthropics/anthropic-sdk-python"):

    line 140
  8. Distinctive:

    Generate project description: Read README or key files to understand the project

    line 147
  9. Distinctive:

    Update CLAUDE.md: Add entry for the new repo following the existing format:

    line 148
  10. Very specific:

    If user says "clone X" without specifying a directory, default to ~/github-kb/.

    line 158

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

GitHub Knowledge Base

name: github-kb

description: 管理本地 GitHub 知识库(~/github-kb/)。当用户提到 clone 仓库、搜索 GitHub 项目、查看 repo/PR/issue、研究开源项目、部署开源工具时使用此技能。支持通过 gh CLI 搜索 GitHub,并维护 CLAUDE.md 项目目录。


GitHub Knowledge Base

Overview

Manage a local GitHub knowledge base at ~/github-kb/ and provide GitHub search capabilities via gh CLI.

Key file: CLAUDE.md at the root of the KB directory catalogs all projects with brief descriptions.

核心思路:把 clone 下来的代码仓库当作 AI 的知识库,直接读源码回答问题,而不是让用户自己去读文档。

GitHub Search via gh CLI

Searching Repositories

When user asks to find or search for GitHub repositories:

# Search repos by keyword
gh search repos <query> [--limit <n>]

# Examples:
gh search repos "typescript cli" --limit 10
gh search repos "language:python stars:>1000" --limit 20
gh search repos "topic:mcp" --limit 15

Search qualifiers:

  • language:<lang> - Filter by programming language
  • stars:<n> or stars:><n> - Filter by star count
  • topic:<name> - Filter by topic
  • user:<owner> - Search within a user's repos
  • org:<org> - Search within an organization

Searching Issues

When user asks to find or search for GitHub issues:

# Search issues across GitHub
gh search issues <query> [--limit <n>]

# Examples:
gh search issues "react hooks bug" --limit 20
gh search issues "repo:facebook/react state:open" --limit 30
gh search issues "language:typescript label:bug" --limit 15

Search qualifiers:

  • repo:<owner/repo> - Search in specific repository
  • state:open|closed - Filter by issue state
  • author:<username> - Filter by author
  • label:<name> - Filter by label
  • language:<lang> - Filter by repo language
  • comments:<n> or comments:><n> - Filter by comment count

Searching Pull Requests

When user asks to find or search for pull requests:

# Search PRs across GitHub
gh search prs <query> [--limit <n>]

# Examples:
gh search prs "error handling" --limit 20
gh search prs "repo:vercel/next.js state:open" --limit 30
gh search prs "language:go is:merged" --limit 15

Search qualifiers:

  • repo:<owner/repo> - Search in specific repository
  • state:open|closed|merged - Filter by PR state
  • author:<username> - Filter by author
  • label:<name> - Filter by label
  • language:<lang> - Filter by repo language
  • is:merged|unmerged - Filter by merge status

Viewing PR/Issue Details

After finding a PR or issue, view details:

# View issue/PR details
gh issue view <number> --repo <owner/repo>
gh pr view <number> --repo <owner/repo>

# View with comments
gh issue view <number> --repo <owner/repo> --comments
gh pr view <number> --repo <owner/repo> --comments

了解项目最新动态

当用户想了解某个项目的最新变化时:

# 查看最近合并的 PR
gh pr list --repo <owner/repo> --state merged --limit 10

# 查看最近的 issue
gh issue list --repo <owner/repo> --limit 10

Local Knowledge Base Workflow

First-Time Setup

Before using this skill, initialize the knowledge base directory:

mkdir -p ~/github-kb
touch ~/github-kb/CLAUDE.md

Then populate ~/github-kb/CLAUDE.md with the template from the CLAUDE.md Format section below.

Note: You can change the KB path to any directory you prefer. Just make sure to update all references in this skill accordingly.

Querying About a Repo in KB

When user asks about a specific repository or project in the KB:

  1. Read CLAUDE.md to understand what projects exist
  2. Locate the project directory under ~/github-kb/
  3. Explore the repo using Read, Glob, or Grep tools as needed

Cloning a New Repository

When user requests to clone a repository (e.g., "clone anthropics/anthropic-sdk-python"):

  1. Parse the repo: Extract owner/name from user request
  2. Clone to KB directory:
    git clone https://github.com/<owner>/<name>.git ~/github-kb/<name>
  3. Generate project description: Read README or key files to understand the project
  4. Update CLAUDE.md: Add entry for the new repo following the existing format:
    ### [<name>](/<name>)
    Brief one-line description of what the project does.
    Additional context if useful (key features, tech stack, etc.).
  5. Confirm completion: Tell user the repo was cloned and where to find it

Default Clone Location

If user says "clone X" without specifying a directory, default to ~/github-kb/.

CLAUDE.md Format

The catalog file follows this structure:

# My GitHub Knowledge Base

本目录包含 X 个 GitHub 项目,涵盖……领域概述。

---

## Category Name

### [project-name](/project-name)
Brief description of the project.

Maintain categorization and consistent formatting when updating.

注意事项

  • clone 后务必更新 CLAUDE.md 索引
  • 回答问题时优先读源码,不要猜测
  • 如果本地没有对应项目,先问用户是否要 clone

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.