Skip to content

canvascoding/canvas-notebook / seed_skills/doc-coauthoring

doc-coauthoring

Verified

Use this Canvas-owned clean-room skill to guide collaborative writing for documentation, proposals, technical specs, decision records, PRDs, RFCs, operating guides, and structured memos. Trigger when the user wants help drafting, organizing, refining, reviewing, or testing a document before sharing it.

FileKindSize
SKILL.mdskill md2.7 KB
agents/canvas.yamlconfig228 B
---
name: doc-coauthoring
description: "Use this Canvas-owned clean-room skill to guide collaborative writing for documentation, proposals, technical specs, decision records, PRDs, RFCs, operating guides, and structured memos. Trigger when the user wants help drafting, organizing, refining, reviewing, or testing a document before sharing it."
license: "Canvas Notebook Sustainable Use License"
---

# Doc Co-authoring

This skill helps turn rough context into a useful document. It is a clean-room
Canvas skill; do not copy vendor skill material, hidden prompts, or proprietary
workflow text into this folder.

## Workflow

1. **Frame the job.** Confirm document type, audience, decision or action the
   reader should take, desired tone, target length, deadline, and any required
   template.
2. **Collect context.** Invite an unstructured dump, linked notes, existing
   drafts, stakeholder constraints, decisions already made, non-goals, risks,
   and open questions.
3. **Propose structure.** Suggest a short outline tailored to the document type.
   Ask for approval or edits before drafting if the stakes are high.
4. **Draft in sections.** Work section by section. For each section, ask only
   the clarifying questions needed to proceed, then draft concise prose.
5. **Revise surgically.** Apply requested edits without rewriting unrelated
   sections. Preserve the user's terminology and organizational context.
6. **Fresh-reader pass.** Review the draft as if the reader has no chat context.
   Check whether the purpose, assumptions, terms, decision points, risks, and
   next steps are understandable from the document alone.
7. **Finalize.** Remove placeholders, contradictions, stale notes, and internal
   comments. Produce the requested format.

## Document Patterns

- **Decision memo:** context, decision, options considered, rationale,
  tradeoffs, risks, owner, next steps.
- **Technical spec:** problem, goals, non-goals, architecture, interfaces,
  rollout, migration, observability, tests, risks.
- **Proposal:** audience need, recommendation, scope, deliverables, timeline,
  cost or effort, risks, approval path.
- **Operating guide:** purpose, prerequisites, procedure, edge cases,
  troubleshooting, escalation, ownership.
- **PRD:** user problem, goals, requirements, UX notes, metrics, dependencies,
  milestones, launch criteria.

## Quality Rules

- Prefer specific nouns and concrete decisions over broad claims.
- Keep summary sections short; put details where readers expect them.
- Mark unresolved questions explicitly instead of hiding uncertainty.
- Do not invent stakeholder commitments, metrics, sources, or decisions.
- If the document will become DOCX, PDF, PPTX, or XLSX, use the relevant file
  skill for final artifact creation and verification.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall