technical-writing-style

Reviews and rewrites Japanese technical documents against prose style and argumentation rules.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/tktcorporation/cli-sim-game-escape --skill technical-writing-style-tktcorporation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-writing-style
Source: https://github.com/tktcorporation/cli-sim-game-escape/tree/main/.claude/skills/technical-writing-style
Command: npx skills add https://github.com/tktcorporation/cli-sim-game-escape --skill technical-writing-style-tktcorporation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Japanese technical documents such as PRDs, design docs, wiki articles, reports, PR descriptions, and issues often suffer from vague argumentation, redundant phrasing, and hollow LLM-style expressions. This Skill provides a concrete style checklist to write and proofread such documents so they read clearly and honestly for external audiences. ## Core Features & Use Cases - Style Rule Checklist: Covers paragraph and argument structure, rigor of reasoning, reader cognitive load, heading design, redundancy removal, and honesty toward readers. - LLM-Tone Detection: Flags formulaic LLM phrases such as "重要なのは", "正面から", "掘り下げる", and empty intensifiers, with guidance on when hedging should be kept versus removed. - Structured Review Output: Produces a findings table with location, category, rationale, and before/after rewrites for each issue. - Use Case: After drafting a PRD in Japanese, run this Skill to receive a categorized list of style violations and concrete rewrites before sharing the document with stakeholders. ## Quick Start Proofread this Japanese design document and list every style violation with suggested rewrites.

Frequently Asked Questions about technical-writing-style

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

FAQPage Schema
How do I remove LLM-style phrases from Japanese technical writing?

Check the document against a list of formulaic expressions such as "重要なのは", "正面から", "掘り下げる", and empty intensifiers like "非常に". Replace preview-style announcements with the claim stated directly, and keep hedging only where it expresses genuine uncertainty.

How do I proofread a Japanese PRD or design document for readability?

Review paragraph structure so each paragraph carries one topic, verify logical connectives between paragraphs, and check that headings identify the section's content. Then remove redundancy and produce a findings table with before-and-after rewrites.

What document types does this writing style check cover?

It covers external-facing Japanese technical documents: PRDs, design docs, wiki articles, reports, pull request descriptions, and issues. Code snippets, logs, and config file excerpts inside those documents are excluded from inspection.

Should all hedging expressions like "かもしれない" be removed?

No. Hedging that expresses genuine uncertainty, reader doubts, or counterfactuals should be preserved. Only hedging that weakens a claim without justification should be removed, and only when the document's own evidence supports a definitive statement.

When should I not use this style checklist?

Do not use it for content fidelity checks, PRD-specific logic review, or PR first-reader context checks, which are handled by separate skills. It also defers insider-jargon and conclusion-only rules to the referenced rule files rather than duplicating them.