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
66%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/18-repo-auditor/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
e9f6648
Table of Contents
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.