CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-technical-docs

Write or review clear, consistent, and accessible prose for Dart and Flutter developer documentation. Use for tutorials, API references, UI text, error messages, code comments, and terminology or style reviews.

Quality

89%

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

86%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.

A well-structured instruction-only style skill: concise rule set with concrete examples, actionable guidance, and exemplary progressive disclosure that splits detail into one-level-deep reference files. Workflow clarity is slightly limited only because the skill is a reference rather than a sequenced process.

DimensionReasoningScore

Conciseness

Mostly efficient rules with concrete do/don't examples and no padding with concepts Claude already knows; a few explanatory asides could be tightened further.

4 / 5

Actionability

Highly actionable, specific guidance throughout (e.g. 'Write in second person: address the reader as you', sentence-case heading examples) covering common cases; absence of code is appropriate for this instruction-only style skill.

5 / 5

Workflow Clarity

No multi-step destructive workflow, but content is well-organized into clear rule categories with an explicit 'read only the references relevant to the text' guidance; minor gaps in sequencing for a review pass.

4 / 5

Progressive Disclosure

Clear overview of core rules with eight well-signaled, one-level-deep reference files, all of which exist and are organized for discovery with descriptive labels.

5 / 5

Total

18

/

20

Passed

Description

87%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 well-constructed description that explicitly states both what the skill does and when to use it, with a clear Dart/Flutter documentation niche. Trigger terms are natural and coverage is strong, with only minor room for added synonyms or file extensions.

DimensionReasoningScore

Specificity

Names two concrete actions ('Write or review') and lists several specific deliverable targets (tutorials, API references, UI text, error messages, code comments, terminology reviews) with minor gaps in action coverage.

4 / 5

Completeness

Clearly answers 'what' (write/review clear prose for Dart/Flutter developer docs) and explicitly answers 'when' with a 'Use for ...' clause listing concrete trigger phrases.

5 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say (documentation, tutorial, API reference, error message, code comments, style review, Dart, Flutter), though a few synonyms and file extensions are missing.

4 / 5

Distinctiveness Conflict Risk

Scoped to a clear niche (Dart and Flutter developer documentation) with distinct, domain-specific triggers, giving minimal conflict risk with other skills.

5 / 5

Total

18

/

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

flutter/website

Path

.agents/skills/write-technical-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.