CtrlK
BlogDocsLog inGet started
Tessl Logo

documenter

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

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/10-documenter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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'

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

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.