writing

Original：🇺🇸 English

Translated

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

1installs

Sourceigorwarzocha/opencode-workflows

Added on2026-02-10

NPX Install

npx skill4agent add igorwarzocha/opencode-workflows writing

SKILL.md Content

View Translation Comparison →

<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_file
```
for sections,
```
str_replace
```
for edits.
Quality over Speed: Each iteration MUST make meaningful improvements. </guidance_tips>

</professional_coauthoring_workflow> </instructions>

writing

NPX Install

Tags

SKILL.md Content