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.
The description effectively communicates its purpose as a repository auditing skill and clearly states when it should be used (before other skills). Its main weaknesses are moderate specificity in the concrete actions performed and limited trigger term coverage, particularly lacking common user-facing synonyms. The explicit 'Use quando' clause and distinct positioning as a prerequisite audit step are strong points.
Suggestions
Add more specific concrete actions beyond 'mapear', such as 'identifica dependências', 'lista endpoints', 'detecta padrões de código', 'cataloga estrutura de diretórios'.
Include natural trigger term variations users might say, such as 'analise do projeto', 'overview do repositório', 'reconhecimento do codebase', 'onboarding', or 'descoberta de stack'.
| 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' (initial and continuous repository auditing — mapping stack, conventions, assets, tests, docs, risks, integration points) and 'when' (before executing other skills, when needing to map the real state of the repository). The 'Use quando' clause explicitly provides trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes some relevant terms like 'auditoria', 'repositorio', 'stack', 'testes', 'docs', 'riscos', 'integracao', but these are mostly in Portuguese and some are fairly technical. Missing common natural-language variations a user might say, such as 'codebase analysis', 'project overview', 'repo scan', or 'onboarding'. | 2 / 3 |
Distinctiveness Conflict Risk | This skill occupies a clear niche as a repository auditing/discovery skill that runs before other skills. The combination of 'auditoria inicial e continua', the specific audit targets, and the explicit positioning as a prerequisite step makes it 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.
This is a well-organized skill that clearly defines its purpose, outputs, and split strategy with useful detection heuristics. Its main weaknesses are the lack of a concrete step-by-step workflow with validation checkpoints and the absence of executable examples or sample output snippets. Some sections are mildly redundant, adding token cost without proportional value.
Suggestions
Add a numbered step-by-step workflow section (e.g., 1. Check existing audit → 2. Detect stack signals → 3. Generate/update splits → 4. Validate completeness → 5. Handoff) with explicit validation checkpoints.
Include a concrete example of what a minimal `current.md` output looks like, even if abbreviated, so the expected format is unambiguous.
Consolidate 'Conteudo Minimo da Auditoria', 'Responsabilidades', and 'Evidencia de Conclusao' which overlap significantly — merge into a single checklist to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably structured but includes some sections that are somewhat redundant or could be tightened. 'Quando Usar/Nao Usar', 'Entradas Esperadas', and 'Responsabilidades' overlap with information already conveyed elsewhere. The Output Split section with the detection table is valuable and dense, but sections like 'Conteudo Minimo da Auditoria' partially repeat what's already in the split catalog and structure sections. | 2 / 3 |
Actionability | The skill provides concrete file paths, split catalog with detection heuristics, and specific patterns to look for (e.g., 'app.get/post/put/delete', 'schema.prisma'). However, it lacks executable code/commands — there are no actual scripts, CLI commands, or concrete examples of what the output markdown should look like. The guidance is specific but descriptive rather than executable. | 2 / 3 |
Workflow Clarity | The skill describes what to produce and when to reaudit, but lacks a clear step-by-step sequence for performing the audit. There's no numbered workflow like 'Step 1: Check for existing audit, Step 2: Run detection, Step 3: Generate splits, Step 4: Validate output.' Validation/verification steps are implicit at best — 'Evidencia de Conclusao' lists expected outputs but doesn't integrate validation into the workflow. | 2 / 3 |
Progressive Disclosure | The skill effectively uses progressive disclosure: it references `docs/skill-guides/repo-auditor.md` for deeper content, points to `templates/audit.md` for structure, and references multiple policy files. References are one level deep and clearly signaled. The split catalog is appropriately inline since it's core to the skill's operation. | 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 | |
d87ad31
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.