CtrlK
BlogDocsLog inGet started
Tessl Logo

packages-documentation

Write, update, and format documentation for @data-client public APIs - API reference (Docusaurus/MDX), README files, JSDoc/TSDoc docstrings, usage examples, migration guides, deprecation notices, changelog entries. Use when changing exported APIs (docs must update in the same PR), writing new package docs, or updating the dataclient.io site.

71

Quality

86%

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

87%

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

The content is concise, actionable, and well-organized for an instruction-only skill. The main gap is the lack of explicit validation feedback loops for the more consequential operations like breaking API changes and deprecations.

Suggestions

Add an explicit validate-then-fix-retry loop for breaking changes and deprecations, e.g. 'After updating docs, re-run the docs build; if it fails, fix the broken references and rebuild before committing.'

Collapse or tighten Examples 1-4, which partly restate the 'Finding the Right Documentation File' workflow, to reduce redundancy.

Clarify the verification step in the checklist so 'verified documentation build correctly' names the actual command or process rather than leaving it implicit.

DimensionReasoningScore

Conciseness

The body is lean, assumes Claude's competence, and avoids explaining basic concepts; content is mostly purposeful with only minor redundancy in the examples section.

3 / 3

Actionability

Provides concrete, specific guidance including exact file-path mappings, a required document structure, and a checklist, which is actionable for an instruction-only skill.

3 / 3

Workflow Clarity

A numbered sequence and checklist exist, but signature changes and deprecations lack explicit validation/feedback checkpoints, and the build-verification step is implicit rather than a clear validate-fix-retry loop.

2 / 3

Progressive Disclosure

Well-organized sections with clear structure and no nested external references; appropriate for a self-contained skill that needs no bundle files.

3 / 3

Total

11

/

12

Passed

Description

85%

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 specific and well-scoped with a clear 'Use when' trigger, though its trigger terms lean somewhat technical and could include more natural user phrasings. It is clearly distinguishable from other documentation skills.

DimensionReasoningScore

Specificity

Lists multiple concrete documentation actions—API reference, README files, JSDoc/TSDoc docstrings, usage examples, migration guides, deprecation notices, changelog entries—matching the multiple-specific-actions anchor.

3 / 3

Completeness

Explicitly states what it does and provides a 'Use when...' clause covering when to invoke it, satisfying both what and when with explicit triggers.

3 / 3

Trigger Term Quality

Includes some natural triggers ('changing exported APIs', 'writing new package docs') but leans on developer jargon and misses common variations like 'update the docs' or 'add docs', so coverage is incomplete.

2 / 3

Distinctiveness Conflict Risk

Scoped specifically to @data-client public API documentation, giving it a clear niche with distinct triggers unlikely to conflict with unrelated skills.

3 / 3

Total

11

/

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
reactive/data-client
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.