CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

repo-auditor

Audita o repositorio e registra sua stack, riscos e convencoes. Trigger em: "repo audit", "auditar repositorio", "mapear stack do projeto", "harnessability score", "repo-audit", "auditoria de repo", "fotografia do repo", "current.md", "mapear convencoes do projeto", "inventariar o codebase".

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/18-repo-auditor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body delivers highly concrete audit guidance — executable churn-gate commands, specific detection patterns for output splits, and genuine validation loops — but it is structurally heavy: roughly 295 lines with an entire sub-mode inlined, duplicated inventory sections, and references to kit files that are not part of the skill bundle.

Suggestions

Move the --recommend-automation catalog (hooks/subagents/skills/MCP tables plus its markdown output template) into a reference file such as references/recommend-automation.md and keep a short trigger-condition summary in SKILL.md, since that content is only needed when the flag is passed.

Merge the overlapping inventories in 'Conteudo Minimo da Auditoria', 'Saidas Esperadas', and 'Evidencia de Conclusao' into a single section (and fold 'Quando Reauditar' into 'Quando Usar') to remove duplicated lists and reduce token cost.

Ship templates/audit.md — or inline a minimal skeleton — in the bundle, and either verify or drop referenced paths such as policies/harness-categories.md and docs/inspiration/harness-engineering.md, since no bundle files currently exist for them.

DimensionReasoningScore

Conciseness

Mostly efficient — dense tables, compact notation ("fn nome(args): tipo", "[auth,db]"), and no explanations of concepts Claude already knows — but the ~295-line body carries redundant overlapping sections ("Conteudo Minimo da Auditoria" vs "Saidas Esperadas" vs "Evidencia de Conclusao") and long inline example blocks. Between anchors 2 and 3: the padding is structural duplication rather than padded prose, so 3 fits better than 2.

3 / 5

Actionability

Provides concrete, executable guidance — copy-paste bash for the churn gate ("find . -name *.ts ... | xargs wc -l | sort -rn | head -20"), specific detection patterns ("schema.prisma", "urlpatterns", "*.entity.ts") and an explicit scoring formula ("max(0, ...)") — but some steps depend on files not shipped in the bundle ("Usar templates/audit.md como base") and on kit-internal skill numbers ("skills 02, 04, 22"). Not 5 because of those unresolved dependencies; not 3 because the core workflow guidance is fully concrete.

4 / 5

Workflow Clarity

The audit sequence (detect → score → split → persist → handoff) is distributed across topic sections rather than one ordered list, but validation checkpoints are explicit and strong: "Checkpoint antes de persistir: ... confirmar contra um arquivo real do repo" and the empty-section feedback loop ("Se esta secao vier vazia, tratar como sinal de auditoria rasa ... Investigar de novo"). Not 5 because there is no single explicitly sequenced workflow for the main audit pass; not 3 because checkpoints are explicit, not implicit.

4 / 5

Progressive Disclosure

The body is well-sectioned with headers and defers deep-dive material appropriately ("consultar docs/skill-guides/repo-auditor.md apenas quando necessario"), but the entire ~60-line recommend-automation sub-mode and full markdown output templates are inlined in SKILL.md when they belong in a reference file, and the bundle ships no files at all — referenced paths like "templates/audit.md" and "policies/harness-categories.md" do not exist under references/. Not 2 because the structure and signaling are genuinely good; not 4 because the inlined sub-mode is a major placement gap, not a minor one.

3 / 5

Total

14

/

20

Passed

Description

91%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 compact, third-person description that clearly states what the skill does and provides an unusually thorough bilingual trigger list with synonyms and the output file path. Its main limitation is that headline capabilities (harnessability scoring, the recommend-automation mode) appear only as trigger terms rather than being described as capabilities.

DimensionReasoningScore

Specificity

Names several concrete actions — "Audita o repositorio e registra sua stack, riscos e convencoes" — but headline capabilities like the harnessability score and --recommend-automation mode are absent from the 'what', leaving minor gaps in coverage. Fits anchor 4 rather than 5 (not comprehensive) and rather than 3 (more than 1-2 concrete actions are named).

4 / 5

Completeness

Explicitly answers both questions: what ("Audita o repositorio e registra sua stack, riscos e convencoes") and when ("Trigger em:" followed by ten concrete trigger phrases). Not 4 because the 'when' is maximally explicit rather than merely present.

5 / 5

Trigger Term Quality

The explicit trigger list gives comprehensive natural coverage with synonyms and variants across both languages — "repo audit", "repo-audit", "auditar repositorio", "auditoria de repo", "mapear stack do projeto", "inventariar o codebase" — plus the output file "current.md". Matches the comprehensive-with-synonyms anchor; no natural phrasing of the intent is missing.

5 / 5

Distinctiveness Conflict Risk

The repo-audit niche is mostly distinct with domain-specific triggers, but "current.md" as a trigger and generic audit phrasing ("auditoria de repo") create minor overlap risk with closely related skills such as security-review or code-review. Not 5 because these triggers could fire in adjacent audit contexts.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository

felvieira/claude-skills-fv

Path

skills/18-repo-auditor/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.