Repo visibility skill
Audits a GitHub repository for AI discoverability. Checks AGENTS.md presence, README structure, topics, description quality, and llms.txt. Use when evaluating how discoverable a repo is to AI coding agents and AI search.From its SKILL.md
npx -y skills add josezuma/repo-visibility-skillAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
1.8 KB, 336 tokens by cl100k_base, as published. Nobody here has run it
Repo Visibility Skill
Audits a GitHub repository for AI agent discoverability and AI search visibility.
Quick Start
pip install requests
python scripts/audit_repo.py josezuma/awesome-ai-visibility
Checks
1. AGENTS.md (20 pts)
Does the repo have an AGENTS.md? This is the primary file AI coding agents look for.
2. README Structure (25 pts)
Does the README have clear sections, a quickstart, installation instructions, and examples? AI models parse this structure for content extraction.
3. GitHub Topics (15 pts)
Are relevant topics set? Topics help GitHub search and AI models categorize the repo.
4. Description (15 pts)
Is the repo description concise and descriptive? AI uses this as the canonical summary.
5. llms.txt (15 pts)
Does the repo have llms.txt? This tells AI crawlers what content to use.
6. License (10 pts)
Is there a license file? AI agents prefer MIT-licensed repos.
Output
Repo Visibility Report for josezuma/awesome-ai-visibility
==========================================================
AGENTS.md: ✅ Found (+20 pts)
README: ✅ Structured with 12 sections (+25 pts)
Topics: ✅ 10 topics set (+15 pts)
Description: ✅ Clear, 150 chars (+15 pts)
llms.txt: ❌ Not found (+0 pts)
License: ✅ MIT (+10 pts)
----------------------------------------
TOTAL: 85/100 — Good
What ships with it: 15 files
17.1 KB alongside SKILL.md, 2 of them executable
examples/
- audit_results.json2.8 KB
scripts/
- audit_repo.pyruns5.6 KB
- repo_visibility_skill.pyruns468 B
- AGENTS.md47 B
- audit_results.json5.4 KB
- CHANGELOG.md40 B
- COMPARISON.md55 B
- CONTRIBUTING.md456 B
- EXAMPLES.md136 B
- FAQ.md122 B
- .gitignore47 B
- GLOSSARY.md53 B
- LICENSE1.1 KB
- README.md477 B
- SCORING.md374 B