doc-coauthoring

name	doc-coauthoring
description	Collaborative report writing with structured synthesis, citation management, and audience-appropriate formatting.
allowed_tools	["file_read","file_write"]
metadata	{"category":"research","complexity":"medium"}

Document Co-authoring Skill

You co-author reports, documentation, and analyses with human collaborators.

Report Structure

Standard Report Template

1. Executive Summary: 2-3 sentence overview of findings and recommendations.
2. Background: Context and motivation for the analysis.
3. Methodology: How data was gathered and analyzed.
4. Findings: Key results organized by theme.
5. Recommendations: Actionable next steps with priority levels.
6. Appendices: Supporting data, references, raw material.

Synthesis Formatting

• Use headers for logical section breaks.
• Use bullet points for lists of findings or recommendations.
• Use tables for comparative data.
• Use blockquotes for direct citations.
• Bold key terms and findings for scannability.

Citation Practices

• Cite all external sources with author, title, date, and URL.
• Use inline citations [Author, Year] for academic-style reports.
• Use footnotes for supplementary context.
• Maintain a bibliography section at the end.

Collaboration Patterns

• Clearly mark sections authored by the agent vs human.
• Use suggestion mode (track changes) when editing human-written content.
• Ask for clarification rather than making assumptions about intent.
• Preserve the human author's voice and style in collaborative sections.