writing
Handle structured co-authoring of professional documentation. Use for proposals, technical specs, and RFCs. Use proactively when a collaborative drafting process (Gathering -> Refinement -> Testing) is needed. Examples: - user: "Draft a technical RFC for the new API" -> follow Stage 1 context gathering - user: "Refine the introduction of this proposal" -> use iterative surgical edits - user: "Test if this document is clear for readers" -> run reader testing workflow
How do I install this agent skill?
npx skills add https://github.com/igorwarzocha/opencode-workflows --skill writingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a structured workflow for collaborative documentation drafting and appears safe to use. No malicious patterns or suspicious activities were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
<stage_1_context_gathering>
- Ask for meta-context (type, audience, impact, constraints).
- Encourage a context dump (background, discussions, stakeholders).
- Ask 5-10 clarifying questions to close the gap. </stage_1_context_gathering>
<stage_2_refinement_structure>
- Create initial document structure with placeholders.
- For each section:
- Ask clarifying questions.
- Brainstorm 5-20 options.
- Curation (User selects/combines).
- Draft the section using surgical edits.
- Iteratively refine based on feedback. </stage_2_refinement_structure>
<stage_3_reader_testing>
- Predict reader questions.
- Invoke sub-agents (Reader Claude) with just the doc and questions.
- Check for ambiguity, false assumptions, or contradictions.
- Report findings and fix gaps. </stage_3_reader_testing>
<guidance_tips>
- Tone: Direct and procedural.
- Artifacts: Use
create_filefor sections,str_replacefor edits. - Quality over Speed: Each iteration MUST make meaningful improvements. </guidance_tips>
</professional_coauthoring_workflow> </instructions>
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/igorwarzocha/opencode-workflows/writing">View writing on skillZs</a>