# Technical Writing

> USE FOR: Prose QA, Vale/Harper, terminology, English/Japanese edits, English-to-Japanese, stable glossaries, rhythm, AI-slop cleanup, publication QA. DO NOT USE FOR: AI detector/humanizer workflows, fresh generation, meaning-changing rewrites, replacing author judgment, publishing, model/cost/privacy, external sharing, or chunking.

- Skill: `i9wa4/technical-writing` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add i9wa4/technical-writing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/i9wa4/technical-writing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: i9wa4 (https://skillmd.com/u/i9wa4)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/i9wa4/technical-writing

---


# Technical Writing

Owns meaning-preserving editing, translation, terminology, rhythm, and QA.

## 1. Workflow

1. Identify surface: English, Japanese, translation, skill text, or QA.
2. Preserve meaning. Do not rewrite commands, identifiers, product
   names, paths, code, links, versions, or APIs for style.
3. Keep glossary/terminology polish here when meanings are stable; use
   `clarify-concepts` first when they are not.
4. For generic/AI-like prose, read
   [Prose Review](references/prose-review.md).
5. For English checks, read
   [Vale And Harper](references/vale-and-harper.md).
6. For English-to-Japanese, clean English first, then read
   [English-to-Japanese Workflow](references/english-to-japanese-workflow.md)
   and [Japanese Writing Style](references/japanese-writing-style.md).
7. For Japanese editorial review, read
   [Japanese Writing Style](references/japanese-writing-style.md).
8. For flat explanatory prose, read
   [Cognitive Rhythm](references/cognitive-rhythm.md). Build rhythm from
   source material.
9. Apply only clarity changes; preserve facts and intent.

## 2. Boundaries

Issue 225/226 boundaries: no automation, model/cost/privacy,
external-sharing approval, derivative publication approval, or chunking.

Do not add direct polished-Japanese drafting from scratch. Repair English
first, then translate or QA Japanese.

## 3. References

- [Vale And Harper](references/vale-and-harper.md)
- [English-to-Japanese Workflow](references/english-to-japanese-workflow.md)
- [Japanese Writing Style](references/japanese-writing-style.md)
- [Prose Review](references/prose-review.md)
- [Cognitive Rhythm](references/cognitive-rhythm.md)