technical-writing v1.0.0A

Immutable. This exact content never changes and is served at /api/v1/blob/5f811aaf2f96744a.

---
name: technical-writing
license: MIT
metadata:
  version: "1.0.0"
description: |
  USE FOR: Technical prose quality, Vale/Harper checks, terminology, English
  and Japanese editorial review, English-to-Japanese translation workflow,
  glossary handling, explanatory prose rhythm, AI-slop cleanup, and
  publication QA. DO NOT USE FOR: AI detector/humanizer workflows, content
  generation from scratch, meaning-changing rewrites, replacing author
  judgment, publishing, model/cost/privacy choices, external sharing, or
  source chunking.
---

# Technical Writing

Owns meaning-preserving prose quality: English/Japanese editing, translation,
terminology, AI-slop cleanup, rhythm, and QA.

## 1. Workflow

1. Identify the surface: English docs, Japanese prose, translation, skill text,
   or publication QA.
2. Preserve technical meaning. Do not rewrite commands, identifiers, product
   names, paths, code, links, versions, or API names for style.
3. For English prose checks, read
   [Vale And Harper](references/vale-and-harper.md).
4. For English-to-Japanese translation, read
   [English-to-Japanese Workflow](references/english-to-japanese-workflow.md)
   and [Japanese Writing Style](references/japanese-writing-style.md).
5. For prose that feels generic or AI-like, read
   [Prose Review](references/prose-review.md) and fix stance, agency,
   concrete claims, structure, rhythm, and filler before punctuation.
6. For accurate but flat explanatory prose, read
   [Cognitive Rhythm](references/cognitive-rhythm.md). Build rhythm from
   source-backed material, not document meta-commentary.
7. Apply only changes that improve clarity without changing facts or intent.

## 2. Boundaries

The #225/#226 documentation-first translation boundary remains: automation,
model/cost/privacy choices, external-sharing approval, derivative publication
approval, and chunking are outside this skill.

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