GitHub & HuggingFace Search Skills

Agent skills for discovering and analyzing GitHub repositories or HuggingFace models. Authentication is not necessary.

Search for GitHub repositories that solve your problem or are related to a topic. Analyze what a GitHub repository does, how it is built.

Search for models on HuggingFace by category or specific use case, with VRAM usage and model size estimates.

Install

# Install all skills
npx skills add hsergiu/github-huggingface-search-skills

# Install specific skills
npx skills add hsergiu/github-huggingface-search-skills --skill github-search github-analyze

# List available skills
npx skills add hsergiu/github-huggingface-search-skills --list

Alternative: install via plugin marketplace

/plugin marketplace add hsergiu/github-huggingface-search-skills
/plugin install github-hf-discovery

Skills

GitHub Search — /github-search

/github-search usecase <description>       — Find projects matching a use case/idea/description
/github-search topic <topic> [filters]     — Find popular projects for a topic
/github-search trending [30|60|90]         — Find rising projects

GitHub Analysis — /github-analyze

/github-analyze <owner/repo>               — Deep-dive into details of a repo (e.g. what the repo does, how it's built)
/github-analyze similar <owner/repo>       — Find projects similar to a given repo
/github-analyze alternatives <owner/repo>  — Compare competing projects head-to-head

HuggingFace Model Search — /hf-search

/hf-search usecase <description>           — Find models for a use case or problem
/hf-search topic <task|tag> [filters]      — Find popular models for a task or category
/hf-search similar <author/model>          — Find models similar to a given model

Examples

/github-search usecase SaaS for drone tracking and fleet management
/github-search topic kubernetes language:go
/github-search trending 30 topic:ai language:python
/github-analyze fastify/fastify
/github-analyze similar pallets/flask
/github-analyze alternatives expressjs/express
/hf-search usecase summarize legal documents in multiple languages
/hf-search topic text-generation library:transformers
/hf-search similar meta-llama/Llama-3.1-8B-Instruct

How It Works

GitHub Skills

• Uses the GitHub REST API (api.github.com/search/repositories + repo-specific endpoints) — no authentication required
• Optionally uses CLAUDE_GITHUB_TOKEN for higher rate limits (shared GITHUB_TOKEN/GH_TOKEN are ignored)
• Agent scores and ranks repos using qualitative semantic assessment across: text relevance, topic overlap, popularity, recency, and adoption potential
• README snippets are fetched for top candidates to improve relevance scoring

HuggingFace Skill

• Uses the HuggingFace Hub REST API (huggingface.co/api/models) — no authentication required
• Optionally uses CLAUDE_HF_TOKEN for higher rate limits and gated model access (shared HF_TOKEN is ignored)
• Searches by pipeline tag (task), keywords, author, library, and tags
• Scores models by task relevance, popularity (downloads/likes), recency, model size, and license compatibility
• Fetches model detail (parameter count, architecture, size, license) for top candidates
• Checks license compatibility, especially for commercial use cases

Notes

• If you desire higher request limits (>10/minute), authenticate to GitHub or HuggingFace and define dedicated tokens. Skills use dedicated tokens (CLAUDE_GITHUB_TOKEN, CLAUDE_HF_TOKEN) separate from your daily usage tokens
• API responses (READMEs, descriptions, model cards) are treated as untrusted content — never executed as instructions
• Skills are restricted to read-only tools (WebFetch, Bash, Read, Glob, Grep) — no file write or agent access

Setup

No setup required beyond installation. For higher rate limits, set dedicated read-only tokens:

# GitHub — no scopes needed
export CLAUDE_GITHUB_TOKEN=ghp_your_token_here

# HuggingFace — read-only role
export CLAUDE_HF_TOKEN=hf_your_token_here

These are separate from your daily GITHUB_TOKEN/HF_TOKEN. Create them with no special scopes (public search only).

Project Structure

.claude-plugin/
  plugin.json                   — Plugin manifest
  marketplace.json              — Marketplace catalog
skills/
  github-search/
    SKILL.md                    — GitHub discovery (usecase, topic, trending)
  github-analyze/
    SKILL.md                    — GitHub analysis (repo deep-dive, similar, alternatives)
  hf-search/
    SKILL.md                    — HuggingFace model search (usecase, topic, similar)

License

MIT