Agent skill · writing content · sundial-org
github-kb
Manage a local GitHub knowledge base and provide GitHub search capabilities via gh CLI. Use when users ask about repos, PRs, issues, request to clone GitHub repositories, explore codebases, or need information about GitHub projects. Supports searching GitHub via gh CLI and managing local KB with GITHUB_KB.md catalog. Configure via GITHUB_TOKEN and GITHUB_KB_PATH environment variables.
Why this skill is useful
Adds specific commands and workflows for managing a GitHub knowledge base that the AI wouldn't reliably generate on its own.
What it needs
Requires gh installed locally. Requires github account access. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
GitHub Knowledge Base Manage a local GitHub knowledge base and provide GitHub search capabilities via gh CLI. Key file: GITHUBKB.md at the root of the KB directory catalogs all projects with brief descriptions. Configuration Set environment variables before use: GITHUBTOKEN - GitHub Personal Access Token (optional, for private repos) GITHUBKBPATH - Path to local KB directory (default: /home/node/clawd/github-kb) Example: Token Privacy: Never hardcode tokens. Inject via environment variables or container secrets. GitHub CLI (gh) Requirement: GitHub CLI must be installed and authenticated. Installation: macOS: brew install gh Linux: apt install gh or see official install guide Windows: winget install GitHub.cli Authentication: Verify: gh auth status If gh is not installed or not authenticated, skip search operations and use only local KB features. Searching Repos 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 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 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 Local Knowledge Base Workflow Querying About a Repo in KB 1. Read GITHUBKB.md to understand what projects exist 2. Locate the project directory under ${GITHUBKBPATH:-/home/node/clawd/github-kb}/ Cloning a New Repo to KB 1. Search GitHub if the full repo name is not known 2. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/github-kb