CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

repo-audit

Audit a repository for agent-readiness in one twenty-minute pass. Checks the instruction surface (CLAUDE.md, rules), imitation surface (naming, duplication, dead code), sensor surface (tests, pre-commit gate, CI), and safety surface (destructive ops, secrets). Marks each item yes, no, or partial, totals the gaps, and picks the cheapest one to close this week. Use when the user asks to "audit the repo", "is this repo agent-ready", "what does an agent meet here", or wants a readiness checklist for Claude Code.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-validated audit procedure with concrete commands, thresholds, decision rules, and a complete output template. Its only deductions are minor redundancy in the safety items and the absence of any progressive-disclosure split for the longer checklist detail.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no explanations of what tests or CI are), with only minor redundancy — the "Never open `.env*` file contents" rule from the Rules section is restated in item 13, and items 12–13 pack many clauses into single long paragraphs that could be trimmed.

4 / 5

Actionability

Guidance is fully executable throughout: concrete commands (`git branch --show-current`, `wc -w`, `git ls-files | grep -iE '\.env|\.pem|\.key|id_rsa|credentials'`), explicit thresholds (2,000 words, spot-check 3+ claims, 2-3 modules), S/M/L cost estimates in hours, and a complete copy-paste output template covering the common cases.

5 / 5

Workflow Clarity

The sequence is clear (precondition gate → rules → checklist A–D → pick → output) with explicit validation checkpoints: the branch precondition with stop-and-ask, the evidence rule ("No evidence, no `YES`"), `git status --short` before and after running the suite, an environment-failure feedback loop for item 8, and a time-box rule for what to do when the budget runs out. The skill is read-only by design, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

Sections are well-organized (Rules → Checklist → Pick → Output format) with all content appropriately inline for a single-pass audit, and no bundle files exist to reference. At ~95 lines the under-50-line simple-skill exception does not apply, and the long evidentiary detail in items 12–13 could arguably live in a reference file, leaving minor organization gaps versus the ideal split.

4 / 5

Total

18

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that states concrete capabilities across four named surfaces and gives explicit, natural trigger phrases in the third person. Its only weaknesses are a slightly generic "audit the repo" trigger that could collide with security-audit skills and a few missing natural variants.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — checking four named surfaces ("instruction surface (CLAUDE.md, rules), imitation surface (naming, duplication, dead code), sensor surface (tests, pre-commit gate, CI), and safety surface"), marking items "yes, no, or partial", totalling gaps, and picking "the cheapest one to close this week" — with comprehensive coverage and no gaps.

5 / 5

Completeness

It explicitly answers both "what" (audits four surfaces, marks each item, totals gaps, picks the cheapest to close) and "when" ("Use when the user asks to..." with concrete trigger phrases), matching the top anchor exactly.

5 / 5

Trigger Term Quality

It quotes literal natural phrases users would say ("audit the repo", "is this repo agent-ready", "wants a readiness checklist for Claude Code"), giving good keyword coverage, though a few plausible variants like "get the repo ready for agents" or "agent onboarding" are missing.

4 / 5

Distinctiveness Conflict Risk

The agent-readiness framing and Claude Code references carve out a clear niche, but the bare trigger "audit the repo" carries minor overlap risk with security-review or code-review style skills a user might mean instead.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

koenighotze/wheel-of-meeting

Path

.claude/skills/repo-audit/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.