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".

80

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-3

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

The body is a well-structured, token-efficient instruction skill: it defines four documentation levels with checklists, a concrete directory layout, sequenced guidance, and one-level-deep external references. It scores strongly across all dimensions.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it does not re-explain what documentation or ADRs are; every section earns its place, with only a trivial duplicate mention of the templates file.

3 / 3

Actionability

Provides concrete, specific guidance — a literal directory tree, per-level mandatory-content checklists, and exact file paths (docs/ops/runbooks/, templates/doc-update.md) — making the instructions directly executable despite being code-free.

3 / 3

Workflow Clarity

Sequences the work by phase ('Quando Documentar': antes de codar, durante o design, durante a implementação, antes do deploy) and supplies a completion checklist ('Evidência de Conclusão'); no destructive/batch operations exist, so missing feedback loops do not cap the score.

3 / 3

Progressive Disclosure

Keeps the overview inline while deferring full templates to a single one-level-deep, clearly signaled reference (docs/skill-guides/documenter-templates.md 'apenas quando necessario'); no deeply nested references and no bundle files to misroute.

3 / 3

Total

12

/

12

Passed

Description

100%Weight 40%Scale 1-3

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 is concise yet comprehensive, stating the skill's purpose, concrete actions, explicit use-conditions, and a rich set of natural trigger terms in a third-person voice. It cleanly satisfies all four dimensions.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'documentar features, APIs, arquitetura, setup, operação, ou manter documentação existente atualizada' — matching the anchor for enumerating specific capabilities rather than vague language.

3 / 3

Completeness

Explicitly answers both what ('Skill de Documentação por nível de decisão') and when ('Use quando precisar documentar...' plus an explicit Trigger list), satisfying the what-AND-when anchor.

3 / 3

Trigger Term Quality

Broad natural-term coverage in both Portuguese and English via 'Trigger em: documentar, documentação, docs, ADR, architecture decision record, README, runbook, troubleshooting, atualizar docs', terms a user would plausibly say.

3 / 3

Distinctiveness Conflict Risk

Carves a clear niche (decision-level documentation) with distinctive triggers unlikely to fire for unrelated skills; not below 2 because it is not generic, and not below 3 because the niche and triggers are well differentiated.

3 / 3

Total

12

/

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.

Validation16 / 16 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.