technical-writing

Draft and refine long-form technical documents with artifact-specific checks.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/ZenkakuHiragana/my-chezmoi-config --skill technical-writing-zenkakuhiragana
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-writing
Source: https://github.com/ZenkakuHiragana/my-chezmoi-config/tree/main/dot_config/opencode/skills/technical-writing
Command: npx skills add https://github.com/ZenkakuHiragana/my-chezmoi-config --skill technical-writing-zenkakuhiragana

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve long-form technical prose quality for reader-oriented artifacts. This skill helps writers produce high-quality long-form technical prose by controlling document form, drafting the piece, and running a bounded critique-revise-recheck loop, with artifact-specific checks to ensure clarity and reader-fit. It does not own missing facts or repository behavior changes; resolve those with the appropriate fact-owning skill first.

Core Features & Use Cases

  • Owns document form, structure, scannability, reader fit, and bounded revision quality for artifacts such as investigation reports, README files, tutorials, how-to guides, reference pages, explanations, CHANGELOG entries, migration notes, and structured chat explanations.
  • Collaboration contracts define how it interacts with other skills (investigation, public-research, implementation) to resolve facts, norms, and changes.

Quick Start

Draft a complete, reader-friendly technical document by selecting the appropriate form, writing the initial draft, and running a bounded critique–revise–recheck loop to refine it.

Frequently Asked Questions about technical-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve the structure and clarity of long-form technical documentation?

To improve technical documentation clarity and structure, select the appropriate document form, draft the piece, and run a bounded critique-revise-recheck loop to refine reader fit. This ensures accurate, well-structured deliverables like READMEs and tutorials.

What is the best way to write a reader-oriented migration guide or CHANGELOG?

Writing a reader-oriented migration guide or CHANGELOG requires selecting the correct document form and applying artifact-specific checks to ensure scannability. A bounded revision loop refines the prose for accurate, structured deliverables.

How do I draft a technical investigation report that fits the reader's needs?

Drafting a technical investigation report involves selecting the proper document form, writing an initial draft, and running a bounded critique-revise-recheck loop. Artifact-specific checks ensure the report meets reader fit and structural standards.

Can I use this approach to refine structured chat explanations and how-to guides?

Yes, you can refine structured chat explanations and how-to guides by selecting the appropriate document form and applying a bounded critique-revise-recheck loop. Artifact-specific checks ensure clarity, structure, and reader fit.

What should I do if my technical prose is missing critical repository behavior facts?

If your technical prose is missing critical repository behavior facts, resolve them with an appropriate fact-owning skill first. This writing skill controls document form and revision quality but does not own missing facts or behavior changes.

Does this technical writing process support reference pages and explanations?

Yes, this technical writing process supports reference pages and explanations by owning document form, structure, and scannability. It applies a bounded critique-revise-recheck loop to ensure the artifact fits the reader's needs.