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
- Frame the job. Confirm document type, audience, decision or action the reader should take, desired tone, target length, deadline, and any required template.
- Collect context. Invite an unstructured dump, linked notes, existing drafts, stakeholder constraints, decisions already made, non-goals, risks, and open questions.
- Propose structure. Suggest a short outline tailored to the document type. Ask for approval or edits before drafting if the stakes are high.
- Draft in sections. Work section by section. For each section, ask only the clarifying questions needed to proceed, then draft concise prose.
- Revise surgically. Apply requested edits without rewriting unrelated sections. Preserve the user's terminology and organizational context.
- 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.
- 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.