{"id":49244945,"url":"https://github.com/mturac/skill-hunter","last_synced_at":"2026-04-24T21:03:52.120Z","repository":{"id":353638414,"uuid":"1220259551","full_name":"mturac/skill-hunter","owner":"mturac","description":"Pre-execution layer for coding agents — scan the ecosystem for existing skills/tools/MCPs before building from scratch.","archived":false,"fork":false,"pushed_at":"2026-04-24T20:11:41.000Z","size":49,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T20:35:56.494Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mturac.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-24T18:03:45.000Z","updated_at":"2026-04-24T20:11:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mturac/skill-hunter","commit_stats":null,"previous_names":["mturac/skill-hunter"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/mturac/skill-hunter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mturac%2Fskill-hunter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mturac%2Fskill-hunter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mturac%2Fskill-hunter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mturac%2Fskill-hunter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mturac","download_url":"https://codeload.github.com/mturac/skill-hunter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mturac%2Fskill-hunter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32240614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-24T21:03:51.289Z","updated_at":"2026-04-24T21:03:52.115Z","avatar_url":"https://github.com/mturac.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Skill Hunter\n\n![Skill Hunter — before you build, scan the ecosystem](./assets/og-image.png)\n\nA pre-execution layer for coding/automation agents (Codex, Claude, OpenClaw, …) that asks a single question before writing any code:\n\n\u003e \"Is there already a skill, MCP server, CLI tool, plugin, repo, template, SDK, API, or workflow that can solve this — or accelerate it?\"\n\nIf yes, it surfaces the best candidate, evaluates risk, and asks for approval before use.\nIf no, it says so plainly and builds manually with a clean, minimal approach.\n\nThe core insight: in agent systems, intelligence is not only knowing how to build — it is knowing **when not to build**.\n\n## Why\n\nThe internet is now a landfill of skills, MCPs, plugins, templates, and half-finished repos. The bottleneck for agents is no longer *capability* — it is *discovery*. Skill Hunter sits in front of execution and prevents:\n\n- rebuilding what already exists\n- picking the most popular tool instead of the right one\n- pulling in abandoned or unsafe repos\n- silently installing things that need credentials or system access\n\n## How it works\n\n1. **Classify** the request (coding, design, browser automation, file conversion, scraping, CI/CD, …).\n2. **Decide** whether a reusable skill/tool likely exists.\n3. **Search** local skills, project docs, GitHub, MCP registry, package managers, tool docs.\n4. **Evaluate** candidates by relevance, maintenance, docs, stack fit, security, effort, licensing.\n5. **Present** one recommendation, a shortlist of three, or an honest \"build it yourself\".\n6. **Gate** on user approval before running anything external.\n\n## Install\n\nFive distribution channels:\n\n### 1. Claude Code plugin (marketplace)\n\n```text\n/plugin marketplace add mturac/skill-hunter\n/plugin install skill-hunter@skill-hunter\n```\n\nClaude installs both the skill and the `UserPromptSubmit` hook from the plugin manifest — no clone, no shell script.\n\n### 2. Codex CLI plugin\n\n```bash\ncodex plugin marketplace add mturac/skill-hunter\n```\n\nThen enable it in `~/.codex/config.toml`:\n\n```toml\n[plugins.\"skill-hunter@skill-hunter\"]\nenabled = true\n```\n\nCodex pulls the marketplace straight from GitHub, no central registry.\n\n### 3. OpenClaw (ClawHub registry)\n\n```bash\nopenclaw skills install openclaw-skill-hunter\n# or via ClawHub CLI\nclawhub install openclaw-skill-hunter\n```\n\nPublished at [clawhub.com/mturac/openclaw-skill-hunter](https://clawhub.com). Drops into `~/.openclaw/skills/`.\n\n### 4. `npx skills` (Hermes and any other agentskills.io-compatible runtime)\n\n```bash\nnpx skills add mturac/skill-hunter@skill_hunter -g -y\n```\n\nInstalls into `~/.agents/skills/skill_hunter/`. The `-g` flag is user-wide; drop it for a per-project install into `./.agents/skills/`.\n\n### 5. Clone + `./install.sh` (development or non-plugin hosts)\n\nUseful when you want the skill to live as a symlink to a checkout so edits propagate without reinstalling:\n\n```bash\ngit clone https://github.com/mturac/skill-hunter.git\ncd skill-hunter\n./install.sh all           # Claude Code + Codex CLI (skill + hook)\n./install.sh status        # verify\n```\n\n---\n\nSkill Hunter ships as a **skill + hook pair** for each runtime:\n\n- The **skill** (`SKILL.md`) gets picked up when the user's prompt matches its description — the standard [agentskills.io](https://agentskills.io) path.\n- The **hook** (`hooks/skill-hunter-hook.sh`) injects the Skill Discovery Pass into *every* interactive turn via `UserPromptSubmit`, so the pass fires even when a more specific skill would otherwise win the matcher.\n\nClone the repo, then run the installer:\n\n```bash\ngit clone https://github.com/mturac/skill-hunter.git\ncd skill-hunter\n./install.sh all           # Claude Code + Codex CLI (skill + hook)\n./install.sh status        # verify\n```\n\nPer-runtime:\n\n```bash\n./install.sh claude        # Claude Code   — ~/.claude/skills/skill_hunter + ~/.claude/hooks.json\n./install.sh codex         # Codex CLI     — ~/.codex/skills/skill_hunter + ~/.codex/hooks/hooks.json\n./install.sh uninstall     # remove skill + hook from both\n```\n\nEach runtime target installs **both** the skill and the hook. The skill is symlinked back to the cloned repo so local edits propagate without reinstalling. Hook registration is idempotent (jq-merged into existing `hooks.json`, no clobbering).\n\nOptional runtimes (no hooks — skill only):\n\n```bash\n./install.sh openclaw      # ~/.openclaw/skills/skill_hunter   (copy — OpenClaw rejects symlinks)\n./install.sh hermes        # ~/.hermes/skills/utility/skill_hunter\n./install.sh cursor        # ./.cursor/rules/skill-hunter.md (per-project)\n```\n\n**Requires:** `jq` (for hook registration). `brew install jq` on macOS.\n\n### What installs where\n\n| Runtime   | Skill path                                  | Hook path                            |\n|-----------|---------------------------------------------|--------------------------------------|\n| Claude Code | `~/.claude/skills/skill_hunter → repo`    | `~/.claude/hooks.json`               |\n| Codex CLI   | `~/.codex/skills/skill_hunter → repo`     | `~/.codex/hooks/hooks.json`          |\n| OpenClaw    | `~/.openclaw/skills/skill_hunter/SKILL.md`  | — (OpenClaw hook API differs)        |\n| Hermes      | `~/.hermes/skills/utility/skill_hunter/SKILL.md` | —                               |\n\nThe hook only fires in **interactive** Claude / Codex sessions. `codex exec` and Claude's `-p` headless modes currently do not fire `UserPromptSubmit` — for those, the skill's implicit matching is the only mechanism.\n\n## Verify it works\n\nOpen `claude` or `codex` (interactive TUI). Type:\n\n```\nScrape e-ticaret sitelerinden fiyat veri çekip günlük CSV olarak kaydet.\n```\n\nExpected: a short **\"Skill Discovery Pass...\"** status indicator, then a structured reply beginning with \"Best candidate:\" (Name / Type / Why it fits / Risk / Effort) or \"Three viable options:\", followed by **\"Use this? 1/2/3\"** before any code is written.\n\nIf the pass doesn't fire, run `./install.sh status` and check that both `skill` and `hook` show `✓` for your runtime.\n\n## Response shapes\n\n**One good candidate**\n\n```\nA reusable skill/tool looks like a good fit for this.\n\nBest candidate:\n- Name: …\n- Type: …\n- Why it fits: …\n- Risk: …\n- Effort: …\n\nUse this?\n1. Yes  2. No, build manually  3. Show alternatives\n```\n\n**Shortlist of three** — side-by-side pros/cons + a pick.\n\n**Nothing good exists** — explicit reason (outdated / too broad / unsafe / low quality), then build manually.\n\n## Examples\n\nSee [`examples/`](./examples) for real interactions — single-candidate pick, 3-way shortlist, skipped discovery, \"build it yourself\", and a credential-scope warning.\n\n## Security posture\n\n- Never install or run unknown tools without approval.\n- Always explain credential/permission scope before recommending a tool that needs them.\n- Prefer official and well-maintained sources. Flag abandoned repos.\n\n## License\n\nMIT — see [`LICENSE`](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmturac%2Fskill-hunter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmturac%2Fskill-hunter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmturac%2Fskill-hunter/lists"}