# 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

- Skill: `majiayu000/writing-guide` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/writing-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/writing-guide/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/writing-guide

---


---
name: writing-guide
description: 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.
---

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

## 実行方法

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

## 禁止事項

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

## 必須要素

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

## 校正チェックリスト

文体:
- [ ] 太字3回未満
- [ ] コロン不使用
- [ ] 定型・推測表現なし

技術的正確性:
- [ ] 情報源あり
- [ ] 具体例あり