Skill de Documentação por nível de decisão. Use quando precisar documentar features, APIs, arquitetura, setup, operação, ou manter documentação existente atualizada. Trigger em: "documentar", "documentação", "docs", "ADR", "architecture decision record", "README", "feature doc", "api doc", "setup doc", "runbook", "troubleshooting", "doc de operação", "registrar decisão", "atualizar docs".
84
Quality
80%
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/10-documenter/SKILL.mdQuality
Discovery
89%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 well-structured skill description with excellent trigger term coverage and clear 'when to use' guidance. The main weakness is that the 'what' portion lists documentation types rather than concrete actions Claude will perform. Adding specific verbs describing the documentation actions would strengthen the specificity dimension.
Suggestions
Add concrete action verbs to describe what Claude does, e.g., 'Cria, atualiza e mantém documentação técnica' or 'Generates ADRs, writes README files, creates runbooks'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (documentation) and lists several types of documentation (features, APIs, arquitetura, setup, operação), but doesn't describe concrete actions beyond 'documentar' and 'manter atualizada'. Missing specific verbs like 'create', 'generate', 'update', 'review'. | 2 / 3 |
Completeness | Clearly answers both what (document features, APIs, architecture, setup, operation, maintain existing docs) and when (explicit 'Use quando' clause plus detailed 'Trigger em:' section with specific keywords). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including both Portuguese and English variations: 'documentar', 'documentação', 'docs', 'ADR', 'README', 'feature doc', 'api doc', 'setup doc', 'runbook', 'troubleshooting'. These are terms users would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on documentation with distinct triggers like 'ADR', 'runbook', 'troubleshooting', 'feature doc'. The specific documentation types and explicit trigger terms make it unlikely to conflict with general coding or other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
70%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-structured documentation skill with excellent progressive disclosure and clear workflow phases. However, it lacks concrete inline examples (actual ADR snippets, API doc examples, curl commands) and relies heavily on external template references, reducing immediate actionability. Some philosophical statements about documentation could be trimmed for better token efficiency.
Suggestions
Add at least one concrete inline example for each documentation level (e.g., a minimal ADR template, a sample API endpoint doc, a DADO/QUANDO/ENTÃO example)
Include a copy-paste ready curl example in the API/Contract section rather than just describing what should be there
Consolidate the multiple template references (mentioned 3+ times) into a single 'Templates' section to reduce redundancy
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some redundant explanations (e.g., explaining what documentation is for, repeating 'nunca' rules). The governance section and multiple template references add overhead that could be consolidated. | 2 / 3 |
Actionability | Provides clear structure and categories but lacks concrete executable examples. No actual code snippets, curl commands, or copy-paste ready templates are included inline—everything references external files like 'documenter-templates.md'. | 2 / 3 |
Workflow Clarity | Clear temporal workflow ('Quando Documentar' section) with explicit phases: before coding, during design, during implementation, before deploy. The 4 levels are well-sequenced with clear 'Conteúdo obrigatório' checklists for each. | 3 / 3 |
Progressive Disclosure | Excellent structure with clear overview and well-signaled one-level-deep references to templates and guides. Directory structure is explicit, and external references (documenter-templates.md, policies/) are clearly indicated without deep nesting. | 3 / 3 |
Total | 10 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
524725e
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.