CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs

Coordinate public plugin documentation across repository, plugin, entity, Astro MDX, and navigation levels, with independent quorum review. Use for documenting skills or agents, plugin docs updates, targeted documentation fixes, and documentation review.

Quality

90%

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

92%Weight 40%Scale 1-5

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

An exceptionally disciplined instruction-only orchestration skill: lean, fully sequenced with validation and feedback loops at every destructive or batch step, and all five bundle references exist and are well signaled. The only weakness is a few under-specified execution details, chiefly the mode-scoring algorithm.

DimensionReasoningScore

Conciseness

The body is lean and dense with zero padding: it never explains concepts Claude already knows and assumes competence throughout (e.g., 'Parse the free-form RU/EN request; extract targets from prose, paths, and optional flags'), so every token earns its place.

5 / 5

Actionability

Mostly executable guidance with concrete commands ('npm --prefix web/docs run build', 'astro check'), exact paths ('web/docs/src/utils/navigation.ts', '.codex/agents/docs-writer.toml'), and precise thresholds (≥2/3 agreement, ±5 lines, at most two fix cycles), but the mode-resolution scoring ('score distinct whole-word keyword/phrase hits below') lacks an exact scoring algorithm and 'available Codex planning/progress tools' is environment-dependent, leaving minor gaps.

4 / 5

Workflow Clarity

The workflow is clearly sequenced (resolve mode → discover and write → review → validate/release/report) with explicit validation checkpoints at every risky step: pre-work bundle verification, quorum agreement rules, bounded fix/re-review feedback loops ('Allow at most two fix/re-review cycles'), mandatory build/check after writes, deploy provenance verification, and live-page verification.

5 / 5

Progressive Disclosure

The body is a well-organized overview that delegates detail via clearly signaled, one-level-deep references, all verified to exist: checklist ('Read [checklist](references/checklist.md) for mode matrices and local acceptance'), review prompt, MDX template, and two scripts, each linked with its stated purpose — no nesting and no inlined reference bulk.

5 / 5

Total

19

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that explicitly states both what the skill does and when to use it, with concrete trigger phrases and a clearly distinct niche. The main gaps are abstract phrasing of the core action ('coordinate') and missing natural synonyms such as README or write-docs.

DimensionReasoningScore

Specificity

The description lists several concrete task types ('documenting skills or agents, plugin docs updates, targeted documentation fixes, and documentation review') and specific surfaces ('repository, plugin, entity, Astro MDX, and navigation levels'), but the primary verb 'coordinate' is abstract and the release/deploy verification work covered in the body is not mentioned, leaving minor gaps in coverage rather than comprehensive coverage.

4 / 5

Completeness

It clearly answers both questions: the 'what' is explicit ('Coordinate public plugin documentation across repository, plugin, entity, Astro MDX, and navigation levels, with independent quorum review') and the 'when' is an explicit 'Use for' clause with four concrete trigger phrases, matching the anchor example's structure exactly.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ('plugin docs updates', 'targeted documentation fixes', 'documentation review', 'documenting skills or agents'), but common variations like 'README', 'write documentation', or file extensions are missing, matching 'good keyword coverage; a few natural terms missing' rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — public plugin documentation across five named levels with quorum review — but triggers like 'documentation review' and 'targeted documentation fixes' have minor overlap risk with a generic documentation or writing skill.

4 / 5

Total

17

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

kochetkov-ma/claude-brewcode

Path

.codex/skills/docs/SKILL.md

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.