What can I search with this skill?

You can search code, repos, issues, and PRs using --type with code, repos, issues, or prs and a GitHub search query.

What are the prerequisites to run it?

A configured MCP server with a github server entry and a valid GITHUB_PERSONAL_ACCESS_TOKEN in mcp_config.json.

How do I filter results?

Use --owner and --repo to narrow results and craft your --query with GitHub search syntax (e.g., language:python, label:critical).

github-search

npx machina-cli add skill parcadei/Continuous-Claude-v3/github-search --openclaw

Files (1)

SKILL.md

1.0 KB

GitHub Search Skill

When to Use

Search code across repositories
Find issues or PRs
Look up repository information

Instructions

uv run python -m runtime.harness scripts/mcp/github_search.py \
    --type "code" \
    --query "your search query"

Parameters

--type: Search type - code, repos, issues, prs
--query: Search query (supports GitHub search syntax)
--owner: (optional) Filter by repo owner
--repo: (optional) Filter by repo name

Examples

# Search code
uv run python -m runtime.harness scripts/mcp/github_search.py \
    --type "code" \
    --query "authentication language:python"

# Search issues
uv run python -m runtime.harness scripts/mcp/github_search.py \
    --type "issues" \
    --query "bug label:critical" \
    --owner "anthropics"

MCP Server Required

Requires github server in mcp_config.json with GITHUB_PERSONAL_ACCESS_TOKEN.

Source

git clone https://github.com/parcadei/Continuous-Claude-v3/blob/main/.claude/skills/github-search/SKILL.mdView on GitHub

Overview

GitHub Search Skill taps MCP to scan GitHub for code, repos, issues, and PRs. It supports GitHub search syntax and optional owner/repo filters to narrow results. This helps developers quickly locate relevant code and project activity across multiple repositories.

How This Skill Works

Invoked via the MCP harness, it runs scripts/mcp/github_search.py with --type and --query. Optional --owner and --repo refine results; a GitHub Personal Access Token must be configured in mcp_config.json. Supported types include code, repos, issues, and prs.

When to Use It

You need to locate code snippets or references across multiple repositories
You want to track issues or pull requests by labels or status
You need repository metadata for a project
You want to perform precise searches using GitHub syntax
You are automating code discovery in MCP workflows

Quick Start

Step 1: Ensure the MCP server has a github entry configured in mcp_config.json and a valid GITHUB_PERSONAL_ACCESS_TOKEN.
Step 2: Run a sample search, for example: --type "code" --query "authentication language:python".
Step 3: Review the results and refine your --query or add --owner/--repo filters as needed.

Best Practices

Use specific queries with language:, owner:, and repo: qualifiers
Choose the correct --type for the target data (code, repos, issues, prs)
Filter by --owner and --repo to narrow results
Ensure your GITHUB token has access to target repos
Test queries with sample inputs and refine progressively

Example Use Cases

uv run python -m runtime.harness scripts/mcp/github_search.py --type "code" --query "authentication language:python"
uv run python -m runtime.harness scripts/mcp/github_search.py --type "issues" --query "bug label:critical" --owner "anthropics"
uv run python -m runtime.harness scripts/mcp/github_search.py --type "repos" --query "topic:devtools" --owner "openai"
uv run python -m runtime.harness scripts/mcp/github_search.py --type "prs" --query "is:open label:documentation" --owner "microsoft"
uv run python -m runtime.harness scripts/mcp/github_search.py --type "code" --query "language:go" --owner "golang" --repo "stdlib"

Frequently Asked Questions

Add this skill to your agents