Does this skill support Markdown formatting?

Yes, it creates and manages structured Markdown files, utilizing artifacts or local file systems to maintain a clean document hierarchy.

What is 'Reader Testing' in this context?

It is a quality control phase where a sub-agent with no prior context 'reads' your draft to identify confusing sections or missing information that a new reader might encounter.

How does the Doc Co-Authoring workflow differ from standard chatting?

Unlike freeform chat, this skill follows a specific sequence—Context, Refinement, and Testing—ensuring all background info is captured before a single line is written.

Can I use this skill for existing documents?

Yes, the skill can read existing files or shared documents via integrations to help you refine, expand, or audit current content.

What happens if I already have a document template?

You can provide the template during Stage 1 (Context Gathering), and the skill will automatically adapt its structural suggestions to match your required format.

Doc Co-Authoring Workflow

Name: Doc Co-Authoring Workflow
Author: Shawn-Guo-CN

byShawn-Guo-CN

0•

Learning & Documentation

Guides users through a structured, three-stage workflow to collaboratively create high-quality technical documentation and proposals.

The Doc Co-Authoring skill transforms Claude into a proactive writing partner for complex documentation tasks. It follows a rigorous three-step process: Context Gathering to align on goals and audience, Refinement & Structure to build content section-by-section via brainstorming, and Reader Testing to identify blind spots using fresh AI perspectives. This skill is ideal for teams needing to produce clear, comprehensive PRDs, RFCs, and technical specifications that are easily understood by both humans and AI models.

Key Features

01Structured three-stage workflow: Context, Refinement, and Testing

02Deep context alignment through guided info-dumping and clarifying questions

03Iterative section-by-section drafting with surgical editing capabilities

04Automated 'Reader Testing' to catch knowledge gaps and logical blind spots

05Support for custom templates and integration with external data sources

060 GitHub stars

Use Cases

01Writing high-stakes project proposals and structured business documentation

02Drafting detailed Product Requirement Documents (PRDs) and Technical Specs

03Creating Request for Comments (RFCs) and Architecture Decision Records (ADRs)

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add shawn-guo-cn/agentfoundry-plugin-marketplace doc-coauthoring

For use in Claude.ai and ChatGPT

Download Skill