github-kb

Original：🇨🇳 Chinese

Translated

GitHub Local Knowledge Base Manager and Query Assistant. This skill must be triggered when users mention github, repo, repository, warehouse, download repo, clone, copy repository, PR, issue, pull request, or any content related to GitHub projects. This skill knows the location of local repos, can clone new repos, and uses gh CLI to search issues, PRs, and repositories to answer questions. Use proactively—even if users just ask "Which repos do I have" or casually mention a GitHub account or project name.

1installs

Sourcerdcrystallab/agentic-plugins

Added on2026-04-18

NPX Install

npx skill4agent add rdcrystallab/agentic-plugins github-kb

SKILL.md Content (Chinese)

View Translation Comparison →

GitHub KB — Local Knowledge Base & GitHub Assistant

Local Repository Root Directory

All local clones are stored in:

~/workspaces/github/

The knowledge base index is maintained at:

@~/workspaces/github/AGENTS.md

Read this file first each time the skill is triggered to confirm which repos are local. If the file or directory does not exist, refer to the "Directory Does Not Exist" section below.

Workflow: Answer GitHub / Repo Related Questions

Step 1 — Prioritize Local Queries

Before connecting to GitHub, confirm whether the repo mentioned by the user has been cloned locally:

bash

ls ~/workspaces/github/

If it exists locally, prioritize reading files directly—it's faster, usable offline, and doesn't consume API quotas.

Step 2 — If Not Local, Use gh CLI to Query GitHub

bash

# Search repository
gh search repos <keyword> --limit 10

# View repo details
gh repo view <owner>/<repo>

# List issues
gh issue list --repo <owner>/<repo> --state open --limit 20

# Search issues
gh search issues <keyword> --repo <owner>/<repo>

# List PRs
gh pr list --repo <owner>/<repo> --state open --limit 20

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

# Search code
gh search code <keyword> --repo <owner>/<repo>

Prioritize using

gh

instead of directly calling

curl

—

gh

handles authentication automatically.

Workflow: Clone New Repository

When the user says to download or clone a repo:

Confirm Repo Name — If the owner/repo is unclear, confirm with the user first.

Clone to Local Root Directory:

bash

git clone https://github.com/<owner>/<repo>.git ~/workspaces/github/<repo>

Generate One-Sentence Summary — Read the repo's README or top-level files and write a one-sentence description (≤ 120 characters).
Update Knowledge Base Index — Add the repo entry to
```
~/workspaces/github/AGENTS.md
```
:
```
- **<repo>** (`<owner>/<repo>`): <one-sentence summary>
```
Entries are sorted alphabetically.

Knowledge Base Index Format

~/workspaces/github/AGENTS.md

uses the following structure:

markdown

# GitHub Local Knowledge Base

This directory stores locally cloned GitHub repositories.

## Repositories

- **repo-name** (`owner/repo-name`): One-sentence description of this repo.
- **another-repo** (`owner/another-repo`): One-sentence description of another repo.

When updating the index:

One entry per repo, sorted alphabetically under
```
## Repositories
```
Format:
```
- **<name>** (
```
<owner>/<name>
```
): <summary>
```
Write the summary in the same language as the user.

Directory Does Not Exist

If

~/workspaces/github/

does not exist during execution:

Inform the user: "Local GitHub directory
```
~/workspaces/github
```
not found."
Ask if the user wants to create it:
```
mkdir -p ~/workspaces/github
```
After the user agrees, create the directory and a blank
```
AGENTS.md
```
index.
Continue executing the user's original request.

Notes

When the user mentions a repo by nickname (e.g., "the claude-code repo"), first try matching records in the local
```
AGENTS.md
```
before asking for confirmation.
When querying the user's own issues or PRs, if no owner is specified, use
```
ricky1698
```
by default.
If
```
gh auth status
```
fails, remind the user to run
```
gh auth login
```
.
Use HTTPS by default when cloning, unless the user explicitly requests SSH.

github-kb

NPX Install

Tags

SKILL.md Content (Chinese)

GitHub KB — Local Knowledge Base & GitHub Assistant

Local Repository Root Directory

Workflow: Answer GitHub / Repo Related Questions

Step 1 — Prioritize Local Queries

Step 2 — If Not Local, Use gh CLI to Query GitHub

Workflow: Clone New Repository

Knowledge Base Index Format

Directory Does Not Exist

Notes