🔭 git-finder (Claude Skill)

A Claude Skill that finds and validates open-source GitHub repos for your project — instead of writing boilerplate from scratch.

You describe a requirement ("real-time face-recognition camera tracker on a wrapper like supervision"); the skill discovers candidates, fetches and reads their code, checks license + activity + architecture, and returns the top 3–4 repos you can build on — with an honest recommendation and a fallback.

What makes it a skill (not a one-off prompt)

It auto-triggers on intent. Once installed, you don't paste a prompt — you just ask "find me a repo for X" or "what should I build Y on top of", and Claude loads this skill on demand. Reusable across every project.

Structure

git-finder/
├── SKILL.md                       # trigger + operating instructions (the brain)
└── references/                    # loaded on demand
    ├── validation_gates.md         # pass/fail gates + ranking (tune thresholds here)
    ├── output_template.md          # the exact report format
    ├── requirements_intake.md      # questions asked when your ask is vague
    └── example_run.md              # a worked input → output example

Hard guarantees

• Never invents repo names, URLs, or stats — unverifiable values are marked UNVERIFIED.
• License is a hard gate — permissive only (MIT / Apache-2.0 / BSD), split licenses flagged.
• Only fetched repos get described — no imagined architecture.
• No application code unless you ask after validation.

Tuning

Edit references/validation_gates.md to change thresholds (maintenance window, allowed licenses, commercial-use requirement). SKILL.md reads from it, so criteria change without touching the core logic.

Install

To use this skill, clone it into your Claude skills directory:

git clone https://github.com/shaikh-saud705/git-finder-skill ~/.claude/skills/git-finder

Then restart Claude Code and run /skills to confirm it loaded.