CtrlK
BlogDocsLog inGet started
Tessl Logo

doc-coauthoring

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

85

1.60x
Quality

74%

Does it follow best practices?

Impact

90%

1.60x

Average score across 7 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/anthropic-doc-coauthoring/SKILL.md

The canonical home for this skill is doc-coauthoring in anthropics/skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body delivers an unusually clear, actionable multi-stage workflow with explicit exit conditions, checkpoints, and feedback loops — the strongest aspect of the skill. Its weaknesses are token efficiency (repeated instruction blocks and announce-style padding) and progressive disclosure: everything is inlined in one long SKILL.md with no reference files, where the manual-testing procedure and detailed step scripts could be split out.

Suggestions

Deduplicate the artifact vs. file creation branches in Stage 2 — state the shared 'inform them + create structure with placeholders' instruction once and keep only the environment-specific difference (artifact link vs. filename confirmation), trimming roughly 10 lines.

Move the Stage 3 'no sub-agents' manual testing procedure into a reference file (e.g., references/manual-testing.md) and keep a one-line pointer in SKILL.md, reducing the main file by ~40 lines and improving progressive disclosure.

Tighten 'Announce intention to...' / 'Inform them that...' framing sentences throughout — replacing them with direct imperatives ('Re-read the entire document and check for: flow, redundancy, contradictions') would cut tokens without losing guidance.

DimensionReasoningScore

Conciseness

The body is mostly efficient procedural instruction with no re-teaching of concepts Claude already knows, but it includes unnecessary repetition and padding — e.g., 'Inform them that the initial structure with placeholders for all sections will be created' appears nearly verbatim in both the artifact and file branches (lines 137-139 and 146-148), and repeated 'Announce intention to...' formulations add tokens without guidance value. This fits anchor 3 ('mostly efficient but could be tightened') better than anchor 4.

3 / 5

Actionability

The guidance is highly concrete and executable: exact question counts ('Generate 5-10 numbered questions', 'brainstorm [5-20] things'), copy-ready curation examples ('Keep 1,4,7,9', 'Remove 3 (duplicates 1)', 'Combine 11 and 12'), named tool commands ('Use `create_file`', 'Use `str_replace`... never reprint the whole doc'), and environment-specific fallbacks (artifacts vs. file, sub-agents vs. manual testing). It stops short of anchor 5 only because sub-agent invocation ('invoke a sub-agent with just the document content and the question') is left unspecified, and no example clarifying questions are provided.

4 / 5

Workflow Clarity

The three stages (Context Gathering, Refinement & Structure, Reader Testing) are clearly sequenced with explicit exit conditions ('Sufficient context has been gathered when questions show understanding...', 'When Reader Claude consistently answers questions correctly...'), explicit transitions between stages, quality checkpoints ('After 3 consecutive iterations with no substantial changes, ask if anything can be removed'), and error-recovery feedback loops ('Loop back to refinement for problematic sections'). This matches the anchor-5 pattern of clear sequence with validation checkpoints and feedback loops.

5 / 5

Progressive Disclosure

No bundle files (references/, scripts/, assets/) exist, so all ~370 lines live inline in SKILL.md. Section headers are clear and the structure is navigable, but content that would fit naturally in one-level-deep reference files — Stage 3's full manual-testing procedure for environments without sub-agents, and the per-step section instructions — is inlined. This fits anchor 3 ('some structure but... content that should be separate is inline') better than anchor 2, since the inline content is well-organized rather than a monolithic wall.

3 / 5

Total

15

/

20

Passed

Description

78%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 clearly and explicitly states both what the skill does and when to use it, with natural trigger phrasing. Its main weakness is that the stated capabilities are workflow-stage abstractions rather than a comprehensive list of concrete actions, and it omits several natural doc-type synonyms (PRD, RFC, design doc) that the body itself targets.

DimensionReasoningScore

Specificity

The description names the domain ("co-authoring documentation") and 2-3 concrete workflow actions ("efficiently transfer context, refine content through iteration, and verify the doc works for readers"), but these are stage-level abstractions rather than a comprehensive list of specific capabilities. It is more concrete than the anchor-2 'names domain, minimal actions' example but lacks the breadth of coverage of anchor 4.

3 / 5

Completeness

It explicitly answers both questions: 'what' ("Guide users through a structured workflow for co-authoring documentation... transfer context, refine content through iteration, and verify the doc works for readers") and 'when' with concrete trigger phrases ("Use when user wants to write documentation, proposals, technical specs, decision docs"; "Trigger when user mentions writing docs, creating proposals, drafting specs"). This matches the anchor-5 example pattern of explicit what + explicit when with trigger phrases.

5 / 5

Trigger Term Quality

It includes natural phrases users would say — "write documentation, proposals, technical specs, decision docs" and "writing docs, creating proposals, drafting specs" — giving good keyword coverage. It falls short of anchor 5 because common variations surfaced in the body (e.g., 'PRD', 'RFC', 'design doc', 'write up') are absent from the description.

4 / 5

Distinctiveness Conflict Risk

The structured multi-stage co-authoring workflow (context gathering, refinement, reader testing) is a distinct niche with its own triggers, giving minimal conflict risk. Not anchor 5 because the broad documentation-writing trigger space ('write a doc', 'draft a proposal') could overlap with generic document-creation skills.

4 / 5

Total

16

/

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
boisenoise/skills-collections
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.