mcpField
W
writing

writing

github.com/igorwarzochaDocuments122111 installsUpdated 38w ago
Repository

About writing

writing is a procedural skill for developing documents through context gathering, iterative drafting, and review. It emphasizes clarifying questions, section-by-section refinement, and checks for ambiguity or contradictions.

Key features

  1. 01Gather audience and constraint context
  2. 02Use clarifying questions to fill gaps
  3. 03Draft and refine sections iteratively
  4. 04Review reader questions and assumptions
  5. 05Check for ambiguity and contradictions
  6. 06Create and edit document artifacts

Use cases

  1. 01Planning a document with stakeholders
  2. 02Drafting a document section by section
  3. 03Reviewing a draft for gaps and inconsistencies

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/igorwarzocha/opencode-workflows --skill writing

After installing, type/writingin Claude Code to confirm it loaded.

Details

From the project README

<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>

Comments

Markdown supported