github-kbManage 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.
Install via ClawdBot CLI:
clawdbot install JamesChan21/github-kbManage a local GitHub knowledge base and provide GitHub search capabilities via gh CLI. Key file: GITHUB_KB.md at the root of the KB directory catalogs all projects with brief descriptions.
Set environment variables before use:
GITHUB_TOKEN - GitHub Personal Access Token (optional, for private repos)GITHUB_KB_PATH - Path to local KB directory (default: /home/node/clawd/github-kb)Example:
export GITHUB_TOKEN="ghp_xxxx..."
export GITHUB_KB_PATH="/your/path/github-kb"Token Privacy: Never hardcode tokens. Inject via environment variables or container secrets.
Requirement: GitHub CLI must be installed and authenticated.
Installation:
brew install ghapt install gh or see official install guidewinget install GitHub.cliAuthentication:
# Interactive login
gh auth login
# Or use token from GITHUB_TOKEN env var
gh auth login --with-token <(echo "$GITHUB_TOKEN")Verify: gh auth status
If gh is not installed or not authenticated, skip search operations and use only local KB features.
# 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 15Search qualifiers:
language: - Filter by programming languagestars: or stars:> - Filter by star counttopic: - Filter by topicuser: - Search within a user's reposorg: - Search within an organizationgh 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 15Search qualifiers:
repo: - Search in specific repositorystate:open|closed - Filter by issue stateauthor: - Filter by authorlabel: - Filter by labellanguage: - Filter by repo languagecomments: or comments:> - Filter by comment count# Search PRs
gh search prs <query> [--limit <n>]
# Examples:
gh search prs "repo:vercel/next.js state:open" --limit 30
gh search prs "language:go is:merged" --limit 15Search qualifiers:
repo: - Search in specific repositorystate:open|closed|merged - Filter by PR stateauthor: - Filter by authorlabel: - Filter by labellanguage: - Filter by repo languageis:merged|unmerged - Filter by merge status# 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
git clone https://github.com/<owner>/<name>.git ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/<name>
### [<name>](/<name>)
Brief one-line description of what the project does. Additional context if useful (key features, tech stack, etc.).If user says "clone X" without specifying a directory, default to ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/.
The catalog file follows this structure:
# GitHub Knowledge Base
This directory contains X GitHub projects covering various domains.
---
## Category Name
### [project-name](/project-name)
Brief description of the project.Maintain categorization and consistent formatting when updating.
Generated Mar 1, 2026
A development team uses the skill to search for open-source libraries or frameworks by language or topic, clone relevant repositories into a local knowledge base for reference, and quickly view issues or PRs to assess community activity or troubleshoot similar problems. This accelerates research and onboarding by centralizing external code examples.
Researchers in computer science or data science utilize the skill to find GitHub repositories related to specific algorithms or datasets, clone them into an organized local directory for analysis, and search issues to understand common challenges or updates. This supports reproducible research and keeps a curated collection of tools and papers.
A DevOps engineer searches for infrastructure-as-code templates, monitoring tools, or CI/CD projects using qualifiers like stars or topics, clones promising repos to evaluate their structure and documentation, and checks PRs to gauge maintenance activity. This aids in selecting reliable tools for deployment pipelines.
A founder explores GitHub for competitors' open-source projects or trending technologies in their domain, clones key repos to analyze code quality and features, and searches issues to identify user pain points or feature requests. This informs product strategy and technical decisions by leveraging community insights.
A technical writer searches for repositories with extensive documentation or specific examples, clones them to extract code snippets or project descriptions, and reviews issues to understand common user questions. This streamlines creating accurate tutorials, guides, or API references for internal or external audiences.
A company builds a platform that integrates this skill's search and local KB capabilities into a web interface, offering advanced analytics, collaboration features, and automated updates for cloned repos. Revenue is generated through subscription tiers for teams, with premium features like AI-powered insights or private instance hosting.
A consultancy uses the skill as a tool to help clients set up and manage local knowledge bases, train teams on efficient GitHub search techniques, and integrate these workflows into their development processes. Revenue comes from project-based fees or retainer contracts for ongoing support and customization.
An enterprise software product bundles this skill with additional features like security scanning, compliance tracking, and integration with internal tools (e.g., Jira, Slack). It targets large organizations needing centralized control over external code assets. Revenue is derived from licensing fees per user or site-wide deployments.
💬 Integration Tip
Ensure the GitHub CLI (gh) is pre-installed and authenticated in the environment, and set GITHUB_TOKEN and GITHUB_KB_PATH as environment variables for seamless operation across different systems.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Query the DeepWiki MCP server for GitHub repository documentation, wiki structure, and AI-powered questions.
Automated GitHub PR code review with diff analysis, lint integration, and structured reports. Use when reviewing pull requests, checking for security issues,...
Essential Git commands and workflows for version control, branching, and collaboration.
Advanced git operations beyond add/commit/push. Use when rebasing, bisecting bugs, using worktrees for parallel development, recovering with reflog, managing subtrees/submodules, resolving merge conflicts, cherry-picking across branches, or working with monorepos.
Format commit messages using the Conventional Commits specification. Use when creating commits, writing commit messages, or when the user mentions commits, git commits, or commit messages. Ensures commits follow the standard format for automated tooling, changelog generation, and semantic versioning.