writing-guide

Use when creating or reviewing technical documentation. Provides guidelines for natural, readable Japanese writing without AI-generated artifacts. Triggers: (1) creating technical documents or READMEs, (2) proofreading or reviewing existing documents, (3) writing blog posts or technical explanations.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026⬇️2downloads

When & Why to Use This Skill

This Claude skill is designed to streamline the creation and refinement of Japanese technical documentation. It enforces high-quality writing standards by eliminating common AI-generated artifacts and ensuring a natural, human-like flow. By providing strict stylistic guidelines—such as limiting formatting excesses and removing repetitive filler phrases—it helps developers and technical writers produce professional, readable, and accurate READMEs, manuals, and technical blog posts.

Use Cases

  • Technical Documentation & README Creation: Automatically generate structured technical documents and README files that follow professional Japanese writing standards and include essential versioning and source information.
  • AI Content Humanization and Proofreading: Review and rewrite existing Japanese documentation to remove 'AI-sounding' patterns, such as excessive bolding, unnatural colons, and repetitive sentence structures, making the text indistinguishable from human-written content.
  • Technical Blog and Knowledge Base Authoring: Draft technical explanations or blog posts that maintain a natural tone while adhering to specific linguistic constraints, ensuring clarity and engagement for a Japanese-speaking technical audience.
namewriting-guide
descriptionUse when creating or reviewing technical documentation. Provides guidelines for natural, readable Japanese writing without AI-generated artifacts. Triggers: (1) creating technical documents or READMEs, (2) proofreading or reviewing existing documents, (3) writing blog posts or technical explanations.

技術ドキュメント作成・校正

実行方法

ドキュメント作成・校正はsubagentを起動して実行すること。 大量のコードからドキュメントを生成する場合はGemini MCPに委託する。

禁止事項

  • 太字(**)は3回未満に制限
  • 見出し・文末でのコロン使用禁止
  • 「以下に〜」「次に〜」「最後に〜」の定型表現禁止
  • 「おそらく」「思われます」など推測表現禁止
  • 同一専門用語の不自然な繰り返し禁止
  • 体言止めの連続使用禁止

必須要素

  • 技術情報にはバージョン情報と情報源を明記
  • 具体例やコード例を提供
  • 自然で人間らしい表現

校正チェックリスト

文体:

  • 太字3回未満
  • コロン不使用
  • 定型・推測表現なし

技術的正確性:

  • 情報源あり
  • 具体例あり