What types of documents can this skill help with?

It is optimized for formal technical documents including RFCs, Architectural Decision Records (ADRs), design proposals, and specifications.

How does the workflow improve document quality?

By moving through three distinct phases—gathering context, iterative refinement, and reader testing—it ensures the document is both technically accurate and accessible to outsiders.

Can I use my own document templates?

Yes, the skill explicitly asks for specific templates or formats during the initial Context Gathering stage to ensure compliance with your organization's standards.

Does it rewrite the whole document every time?

No, it focuses on surgical edits, updating only the necessary sections to preserve the overall structure and context without unnecessary repetition.

Technical Document Co-authoring

Name: Technical Document Co-authoring
Author: kriscard

bykriscard

•

コンテンツ管理

Facilitates the collaborative creation of technical documents like RFCs, ADRs, and proposals through a structured three-stage workflow.

This skill transforms Claude into a strategic partner for drafting high-stakes technical documentation. It moves beyond simple text generation by employing a gather-refine-test framework that ensures deep context alignment, iterative section building, and rigorous reader-perspective testing. By prompting users to close context gaps and anticipate stakeholder questions, it helps teams produce professional RFCs, Architecture Decision Records (ADRs), and project proposals that are clear, comprehensive, and ready for immediate review.

主な機能

01Reader testing simulation to identify blind spots and missing information

02Structured three-stage workflow: Context Gathering, Refinement, and Reader Testing

03Surgical document editing to maintain flow while incorporating precise updates

04Deep context alignment through targeted questioning to eliminate technical ambiguity

052 GitHub stars

06Iterative section-by-section drafting with brainstorming and curation cycles

ユースケース

01Co-authoring a Request for Comments (RFC) for a new team standard or tool

02Refining a complex project proposal that needs to be accessible to stakeholders

03Drafting an Architecture Decision Record (ADR) for a major system change

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kriscard/kriscard-claude-plugins doc-coauthoring

For use in Claude.ai and ChatGPT

主な機能

01Reader testing simulation to identify blind spots and missing information

02Structured three-stage workflow: Context Gathering, Refinement, and Reader Testing

03Surgical document editing to maintain flow while incorporating precise updates

04Deep context alignment through targeted questioning to eliminate technical ambiguity

052 GitHub stars

06Iterative section-by-section drafting with brainstorming and curation cycles

ユースケース

01Co-authoring a Request for Comments (RFC) for a new team standard or tool

02Refining a complex project proposal that needs to be accessible to stakeholders

03Drafting an Architecture Decision Record (ADR) for a major system change

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kriscard/kriscard-claude-plugins doc-coauthoring

For use in Claude.ai and ChatGPT