← Explore all skills

DOCUMENTATION / getsentry

Collaborative Document Drafting

Build a substantial document through context gathering, section refinement and reader testing.

“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.”

01 / THE REASONING

Why this made the selection.

  • The workflow offers a freeform alternative, separates context from refinement and uses a reader without the original conversation to find hidden assumptions.
  • Draft a decision proposal that a fresh reader can understand without the author conversation.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/doc-coauthoring/SKILL.md
  • LICENSE
  • README.md

Our findings

  • The workflow offers a freeform alternative, separates context from refinement and uses a reader without the original conversation to find hidden assumptions.
  • Reader review passes each question with only the document content, then separately checks ambiguity, false assumptions, and contradictions; the final review still asks the author to check facts, links, and technical details.

Not established by this review

  • Third-party instructions and helpers were not executed; service access, host compatibility and outcomes remain untested.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx skills add getsentry/skills/skills/doc-coauthoring

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

npx skills add https://github.com/getsentry/skills/tree/d18b7aa8ba878354e5c348310230e652f7690f9c/skills/doc-coauthoring
  1. Install the pinned directory interactively and retain its referenced files; inspect the source before granting tool access.
  2. Confirm audience, purpose and template; collect source context, revise one section at a time and test realistic reader questions against the resulting document.

Before you start

  • Document editor or writable Markdown path; optional connected knowledge tools and isolated reviewer

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/getsentry/skills/blob/d18b7aa8ba878354e5c348310230e652f7690f9c/skills/doc-coauthoring/SKILL.md

    Supports: summary, review, install, access, limitations

  2. Pinned LICENSE ↗Checked

    https://github.com/getsentry/skills/blob/d18b7aa8ba878354e5c348310230e652f7690f9c/LICENSE

    Supports: license

  3. Pinned README.md ↗Checked

    https://github.com/getsentry/skills/blob/d18b7aa8ba878354e5c348310230e652f7690f9c/README.md

    Supports: summary, review, install, access, limitations

  4. https://raw.githubusercontent.com/getsentry/skills/d18b7aa8ba878354e5c348310230e652f7690f9c/skills/doc-coauthoring/SKILL.md

    Supports: review.findings, bestFor, limitations

Evidence & Ask