CtrlK
BlogDocsLog inGet started
Tessl Logo

repo-auditor

Skill de auditoria inicial e continua do repositorio. Use quando precisar mapear stack real, convencoes, assets, testes, docs, riscos e pontos de integracao antes de executar outras skills. O resultado deve ser persistido em markdown reutilizavel para reduzir releitura e economizar tokens.

71

Quality

66%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/18-repo-auditor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

75%

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

This is a reasonably well-crafted skill description that clearly defines its purpose as a repository auditing skill and explicitly states when it should be used. Its main weaknesses are moderate specificity in the concrete actions performed and limited trigger term coverage, particularly for users who might phrase their needs differently. The explicit 'Use quando' clause and clear positioning as a prerequisite skill are strong points.

Suggestions

Add more specific concrete actions beyond 'mapear' — e.g., 'identifica dependências, analisa estrutura de diretórios, detecta padrões de código, cataloga endpoints de API'.

Expand trigger terms with common user phrases and variations: 'analyze codebase', 'project overview', 'repo structure', 'tech stack discovery', 'code audit', 'onboarding to new project'.

DimensionReasoningScore

Specificity

Names the domain (repository auditing) and lists several areas it covers (stack, conventions, assets, tests, docs, risks, integration points), but the actions are somewhat vague — 'mapear' (map) is the only concrete verb, and the outputs are described generically as 'markdown reutilizavel'.

2 / 3

Completeness

Clearly answers both 'what' (audit repository to map stack, conventions, assets, tests, docs, risks, integration points and persist results in reusable markdown) and 'when' (explicitly states 'Use quando precisar mapear stack real... antes de executar outras skills'). The 'Use quando' clause is explicit and well-defined.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'auditoria', 'repositorio', 'stack', 'testes', 'docs', 'riscos', 'integracao', but these are mostly domain-specific Portuguese terms. Missing common natural user phrases like 'analyze repo', 'codebase overview', 'project structure', or 'onboarding'. The language barrier may also reduce trigger matching for English-speaking users.

2 / 3

Distinctiveness Conflict Risk

The description carves out a clear niche as an initial/continuous repository audit skill that runs before other skills. The combination of auditing scope (stack, conventions, risks, integration points) and the explicit positioning as a prerequisite step makes it highly distinctive and unlikely to conflict with other skills.

3 / 3

Total

10

/

12

Passed

Implementation

57%

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

The skill provides a solid conceptual framework for repository auditing with good progressive disclosure and a well-designed split catalog system. However, it lacks a concrete step-by-step execution workflow with validation checkpoints, and several sections are redundant or too abstract to be immediately actionable. The detection heuristics are a strength but would benefit from being embedded in an explicit numbered procedure.

Suggestions

Add a numbered step-by-step workflow section (e.g., '1. Check for existing audit → 2. Run detection checks → 3. Generate current.md → 4. Generate relevant splits → 5. Validate completeness → 6. Handoff') with explicit validation checkpoints between steps.

Remove or merge redundant sections: 'Entradas Esperadas' adds little value, 'Responsabilidades' overlaps with other sections, and 'Quando Reauditar' partially duplicates 'Quando Usar'.

Include a concrete inline example of what a minimal `current.md` output looks like (even 10-15 lines) so Claude has a clear target format rather than just a description of contents.

Add a validation step: after generating splits, verify each is under ~200 lines and that current.md correctly references all generated splits.

DimensionReasoningScore

Conciseness

The skill is reasonably structured but includes some redundant sections (e.g., 'Quando Usar' vs 'Quando Reauditar' overlap, 'Entradas Esperadas' is vague and adds little value, 'Responsabilidades' largely restates what's already covered elsewhere). The split catalog and detection rules are efficient, but overall the document could be tightened by ~30%.

2 / 3

Actionability

The split catalog with detection heuristics (e.g., check for 'schema.prisma', 'Dockerfile', etc.) provides concrete guidance, and the output file paths are specific. However, there are no executable code examples, no concrete commands for running the audit, and the 'Conteudo Minimo' section is a checklist of topics rather than actionable steps with specific formats or templates shown inline.

2 / 3

Workflow Clarity

The skill describes what to produce and when to trigger, but lacks a clear sequential workflow with numbered steps for actually performing the audit. There are no validation checkpoints (e.g., verify the audit is complete, validate split file sizes, confirm git diff before incremental update). The process is implied rather than explicitly sequenced.

2 / 3

Progressive Disclosure

The skill effectively uses progressive disclosure: it references `docs/skill-guides/repo-auditor.md` for deeper guidance, points to `templates/audit.md` for structure, and references multiple policy files. The split catalog itself is a form of progressive disclosure for output. References are one level deep and clearly signaled.

3 / 3

Total

9

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
felvieira/claude-skills-fv
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.