doc-coauthoring

Guides users through a structured, iterative document creation workflow with clarifying questions and targeted edits.

302|22|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/JetBrains/skills --skill doc-coauthoring-jetbrains
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/JetBrains/skills/tree/main/doc-coauthoring
Command: npx skills add https://github.com/JetBrains/skills --skill doc-coauthoring-jetbrains

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users through a structured, iterative workflow for co-authoring documentation, reducing back-and-forth and improving reader comprehension.

Core Features & Use Cases

  • Guided three-stage process (Context Gathering, Refinement & Structure, Reader Testing) to manage authoring projects from start to finish.
  • Trigger-based offers for when to apply the workflow (writing docs, proposals, specs, or decision documents) and how to proceed through stages.
  • Optional artifact-based drafting and review loop to accelerate collaboration and maintain alignment with stakeholders.

Quick Start

Accept the workflow and begin Stage 1 by sharing the document type, audience, and pertinent context.

Frequently Asked Questions about doc-coauthoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to co-author technical proposals and specs with stakeholders?

A structured workflow guides document creation through context gathering, refinement, and reader testing. This iterative process reduces back-and-forth and improves reader comprehension for proposals and specifications.

How do I start writing documentation when I only have a rough idea of the audience?

Start writing documentation by sharing the document type, target audience, and pertinent context. The workflow uses clarifying questions during the context gathering stage to establish the necessary foundation before drafting begins.

Can I use a staged process to manage document creation from start to finish?

Yes, a staged process manages document creation through context gathering, refinement and structure, and optional reader testing. This guides projects from start to finish while validating document clarity.

How do I validate the clarity of a specification before sending it to stakeholders?

Validate the clarity of a specification by applying optional reader testing. This workflow stage tests the drafted document to ensure it is comprehensible and aligns with stakeholder expectations before final delivery.

Does iterative document drafting work for decision docs and proposals?

Iterative document drafting works effectively for decision docs and proposals. The workflow supports artifact creation and targeted edits, accelerating collaboration and maintaining alignment with stakeholders throughout the process.

When do I need a structured workflow for document collaboration?

You need a structured workflow for document collaboration when writing proposals, specifications, or decision documents. It provides trigger-based guidance and template support to manage authoring projects efficiently from start to finish.