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.

Install with Tessl CLI

npx tessl i github:boisenoise/skills-collections --skill doc-coauthoring

What are skills?

1.59x

Review — 79%

Does it follow best practices?

If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:

npx tessl skill review --optimize ./path/to/skill

Learn more

Evaluation — 91%

↑ 1.59x

Agent success when using this skill

Validation — 11 / 11 Passed

Validation for skill structure

SKILL.md

Review

Evals

Evaluation results

76%

64%

Context Gathering Chatbot Script

Context gathering workflow

Criteria

Without context

With context

Five meta-context questions

20%

100%

Shorthand encouragement

100%

Info dump topic areas

10%

100%

Don't worry about organizing

100%

Multiple input methods

Numbered clarifying questions

100%

Shorthand answer format

100%

Exit condition logic

30%

100%

Integration mention

Confirmation before search

Transition prompt

60%

100%

84%

51%

Document Drafting Assistant Tool

Section-by-section refinement

Criteria

Without context

With context

Six-step section workflow

50%

100%

Brainstorm range 5-20

50%

Curation shorthand examples

100%

Freeform feedback handling

75%

Gap check step

100%

Targeted edits only

100%

70%

Section suggestion

100%

Section ordering by unknowns

100%

First section style note

50%

Three-iteration removal check

62%

Placeholder scaffold creation

100%

94%

Document Quality Checker

Reader testing process

Criteria

Without context

With context

Reader question generation

100%

Fresh perspective testing

40%

Ambiguity check

100%

Assumption check

100%

Contradiction check

100%

Issue reporting

100%

Fix recommendations

100%

Readiness determination

100%

Question answer evaluation

100%

Sample doc issues found

100%

28%

End-to-End Document Co-Authoring Assistant

Full workflow orchestration

Criteria

Without context

With context

Three-stage structure

100%

Initial workflow offer

100%

Stage transition logic

100%

Skip/deviation handling

100%

Frustration handling

100%

Direct tone

100%

Final review recommendations

100%

Final tips provided

100%

Near-completion review

100%

Example session completeness

100%

Brainstorming not in artifacts

100%

24%

Document Scaffold Generator

Document scaffold and section ordering

Criteria

Without context

With context

Section suggestions per type

100%

Unknowns-first ordering

100%

Summary sections last

100%

Decision doc ordering

100%

Tech spec ordering

100%

Placeholder content

100%

User customization

100%

Review checks flow

100%

Review checks redundancy

100%

Review checks filler

100%

Markdown file output

100%

Evaluated: 19 days ago
Agent: Claude Code

Table of Contents

Context Gathering Chatbot Script Document Drafting Assistant Tool Document Quality Checker End-to-End Document Co-Authoring Assistant Document Scaffold Generator

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.