{
  "schemaVersion": "1.0",
  "item": {
    "slug": "github-kb",
    "name": "GitHub Knowledge Base",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/JamesChan21/github-kb",
    "canonicalUrl": "https://clawhub.ai/JamesChan21/github-kb",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/github-kb",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=github-kb",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "github-kb",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T18:11:13.802Z",
      "expiresAt": "2026-05-10T18:11:13.802Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=github-kb",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=github-kb",
        "contentDisposition": "attachment; filename=\"github-kb-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "github-kb"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/github-kb"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/github-kb",
    "agentPageUrl": "https://openagent3.xyz/skills/github-kb/agent",
    "manifestUrl": "https://openagent3.xyz/skills/github-kb/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/github-kb/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "GitHub Knowledge Base",
        "body": "Manage 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."
      },
      {
        "title": "Configuration",
        "body": "Set environment variables before use:\n\nGITHUB_TOKEN - GitHub Personal Access Token (optional, for private repos)\nGITHUB_KB_PATH - Path to local KB directory (default: /home/node/clawd/github-kb)\n\nExample:\n\nexport GITHUB_TOKEN=\"ghp_xxxx...\"\nexport GITHUB_KB_PATH=\"/your/path/github-kb\"\n\nToken Privacy: Never hardcode tokens. Inject via environment variables or container secrets."
      },
      {
        "title": "GitHub CLI (gh)",
        "body": "Requirement: GitHub CLI must be installed and authenticated.\n\nInstallation:\n\nmacOS: brew install gh\nLinux: apt install gh or see official install guide\nWindows: winget install GitHub.cli\n\nAuthentication:\n\n# Interactive login\ngh auth login\n\n# Or use token from GITHUB_TOKEN env var\ngh auth login --with-token <(echo \"$GITHUB_TOKEN\")\n\nVerify: gh auth status\n\nIf gh is not installed or not authenticated, skip search operations and use only local KB features."
      },
      {
        "title": "Searching Repos",
        "body": "# Search repos by keyword\ngh search repos <query> [--limit <n>]\n\n# Examples:\ngh search repos \"typescript cli\" --limit 10\ngh search repos \"language:python stars:>1000\" --limit 20\ngh search repos \"topic:mcp\" --limit 15\n\nSearch qualifiers:\n\nlanguage:<lang> - Filter by programming language\nstars:<n> or stars:><n> - Filter by star count\ntopic:<name> - Filter by topic\nuser:<owner> - Search within a user's repos\norg:<org> - Search within an organization"
      },
      {
        "title": "Searching Issues",
        "body": "gh search issues \"react hooks bug\" --limit 20\ngh search issues \"repo:facebook/react state:open\" --limit 30\ngh search issues \"language:typescript label:bug\" --limit 15\n\nSearch qualifiers:\n\nrepo:<owner/repo> - Search in specific repository\nstate:open|closed - Filter by issue state\nauthor:<username> - Filter by author\nlabel:<name> - Filter by label\nlanguage:<lang> - Filter by repo language\ncomments:<n> or comments:><n> - Filter by comment count"
      },
      {
        "title": "Searching Pull Requests",
        "body": "# Search PRs\ngh search prs <query> [--limit <n>]\n\n# Examples:\ngh search prs \"repo:vercel/next.js state:open\" --limit 30\ngh search prs \"language:go is:merged\" --limit 15\n\nSearch qualifiers:\n\nrepo:<owner/repo> - Search in specific repository\nstate:open|closed|merged - Filter by PR state\nauthor:<username> - Filter by author\nlabel:<name> - Filter by label\nlanguage:<lang> - Filter by repo language\nis:merged|unmerged - Filter by merge status"
      },
      {
        "title": "Viewing PR/Issue Details",
        "body": "# View issue/PR details\ngh issue view <number> --repo <owner/repo>\ngh pr view <number> --repo <owner/repo>\n\n# View with comments\ngh issue view <number> --repo <owner/repo> --comments\ngh pr view <number> --repo <owner/repo> --comments"
      },
      {
        "title": "Querying About a Repo in KB",
        "body": "Read GITHUB_KB.md to understand what projects exist\nLocate the project directory under ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/"
      },
      {
        "title": "Cloning a New Repo to KB",
        "body": "Search GitHub if the full repo name is not known\nClone to KB directory:\ngit clone https://github.com/<owner>/<name>.git ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/<name>\n\n\nGenerate project description: Read README or key files to understand the project\nUpdate GITHUB_KB.md: Add entry for the new repo following the existing format:\n### [<name>](/<name>)\nBrief one-line description of what the project does. Additional context if useful (key features, tech stack, etc.).\n\n\nConfirm completion: Tell user the repo was cloned and where to find it"
      },
      {
        "title": "Default Clone Location",
        "body": "If user says \"clone X\" without specifying a directory, default to ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/."
      },
      {
        "title": "GITHUB_KB.md Format",
        "body": "The catalog file follows this structure:\n\n# GitHub Knowledge Base\n\nThis directory contains X GitHub projects covering various domains.\n\n---\n\n## Category Name\n\n### [project-name](/project-name)\nBrief description of the project.\n\nMaintain categorization and consistent formatting when updating."
      }
    ],
    "body": "GitHub Knowledge Base\n\nManage 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.\n\nConfiguration\n\nSet environment variables before use:\n\nGITHUB_TOKEN - GitHub Personal Access Token (optional, for private repos)\nGITHUB_KB_PATH - Path to local KB directory (default: /home/node/clawd/github-kb)\n\nExample:\n\nexport GITHUB_TOKEN=\"ghp_xxxx...\"\nexport GITHUB_KB_PATH=\"/your/path/github-kb\"\n\n\nToken Privacy: Never hardcode tokens. Inject via environment variables or container secrets.\n\nGitHub CLI (gh)\n\nRequirement: GitHub CLI must be installed and authenticated.\n\nInstallation:\n\nmacOS: brew install gh\nLinux: apt install gh or see official install guide\nWindows: winget install GitHub.cli\n\nAuthentication:\n\n# Interactive login\ngh auth login\n\n# Or use token from GITHUB_TOKEN env var\ngh auth login --with-token <(echo \"$GITHUB_TOKEN\")\n\n\nVerify: gh auth status\n\nIf gh is not installed or not authenticated, skip search operations and use only local KB features.\n\nSearching Repos\n# Search repos by keyword\ngh search repos <query> [--limit <n>]\n\n# Examples:\ngh search repos \"typescript cli\" --limit 10\ngh search repos \"language:python stars:>1000\" --limit 20\ngh search repos \"topic:mcp\" --limit 15\n\n\nSearch qualifiers:\n\nlanguage:<lang> - Filter by programming language\nstars:<n> or stars:><n> - Filter by star count\ntopic:<name> - Filter by topic\nuser:<owner> - Search within a user's repos\norg:<org> - Search within an organization\nSearching Issues\ngh search issues \"react hooks bug\" --limit 20\ngh search issues \"repo:facebook/react state:open\" --limit 30\ngh search issues \"language:typescript label:bug\" --limit 15\n\n\nSearch qualifiers:\n\nrepo:<owner/repo> - Search in specific repository\nstate:open|closed - Filter by issue state\nauthor:<username> - Filter by author\nlabel:<name> - Filter by label\nlanguage:<lang> - Filter by repo language\ncomments:<n> or comments:><n> - Filter by comment count\nSearching Pull Requests\n# Search PRs\ngh search prs <query> [--limit <n>]\n\n# Examples:\ngh search prs \"repo:vercel/next.js state:open\" --limit 30\ngh search prs \"language:go is:merged\" --limit 15\n\n\nSearch qualifiers:\n\nrepo:<owner/repo> - Search in specific repository\nstate:open|closed|merged - Filter by PR state\nauthor:<username> - Filter by author\nlabel:<name> - Filter by label\nlanguage:<lang> - Filter by repo language\nis:merged|unmerged - Filter by merge status\nViewing PR/Issue Details\n# View issue/PR details\ngh issue view <number> --repo <owner/repo>\ngh pr view <number> --repo <owner/repo>\n\n# View with comments\ngh issue view <number> --repo <owner/repo> --comments\ngh pr view <number> --repo <owner/repo> --comments\n\nLocal Knowledge Base Workflow\nQuerying About a Repo in KB\nRead GITHUB_KB.md to understand what projects exist\nLocate the project directory under ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/\nCloning a New Repo to KB\nSearch GitHub if the full repo name is not known\nClone to KB directory:\ngit clone https://github.com/<owner>/<name>.git ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/<name>\n\nGenerate project description: Read README or key files to understand the project\nUpdate GITHUB_KB.md: Add entry for the new repo following the existing format:\n### [<name>](/<name>)\nBrief one-line description of what the project does. Additional context if useful (key features, tech stack, etc.).\n\nConfirm completion: Tell user the repo was cloned and where to find it\nDefault Clone Location\n\nIf user says \"clone X\" without specifying a directory, default to ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/.\n\nGITHUB_KB.md Format\n\nThe catalog file follows this structure:\n\n# GitHub Knowledge Base\n\nThis directory contains X GitHub projects covering various domains.\n\n---\n\n## Category Name\n\n### [project-name](/project-name)\nBrief description of the project.\n\n\nMaintain categorization and consistent formatting when updating."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/JamesChan21/github-kb",
    "publisherUrl": "https://clawhub.ai/JamesChan21/github-kb",
    "owner": "JamesChan21",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/github-kb",
    "downloadUrl": "https://openagent3.xyz/downloads/github-kb",
    "agentUrl": "https://openagent3.xyz/skills/github-kb/agent",
    "manifestUrl": "https://openagent3.xyz/skills/github-kb/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/github-kb/agent.md"
  }
}