Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
igorwarzocha avatar

Writing

  • 92 installs
  • 125 repo stars
  • Updated February 4, 2026
  • igorwarzocha/opencode-workflows

Co-author professional documents like proposals, specs, and RFCs through a gather, refine, and reader-test workflow.

About

A skill for structured collaborative drafting of professional documentation. A developer uses it to gather context, iteratively refine sections with surgical edits, and reader-test the draft with sub-agents.

  • Three stages: context gathering, refinement structure, reader testing
  • Brainstorm-then-curate per section; sub-agent reader testing

Writing by the numbers

  • 92 all-time installs (skills.sh)
  • +3 installs in the week ending Aug 2, 2026 (Skillselion tracking)
  • Ranked #662 of 1,879 Documentation skills by installs in the Skillselion catalog
  • Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/igorwarzocha/opencode-workflows --skill writing

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs92
repo stars125
Last updatedFebruary 4, 2026
Repositoryigorwarzocha/opencode-workflows

What it does

Co-author professional documents like proposals, specs, and RFCs through a gather, refine, and reader-test workflow.

Files

SKILL.mdMarkdownGitHub ↗

<instructions> <professional_coauthoring_workflow>

<stage_1_context_gathering> 1. Ask for meta-context (type, audience, impact, constraints). 2. Encourage a context dump (background, discussions, stakeholders). 3. Ask 5-10 clarifying questions to close the gap. </stage_1_context_gathering>

<stage_2_refinement_structure> 1. Create initial document structure with placeholders. 2. 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> 1. Predict reader questions. 2. Invoke sub-agents (Reader Claude) with just the doc and questions. 3. Check for ambiguity, false assumptions, or contradictions. 4. 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>

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.