writing-guide

Generate and review Japanese technical documentation with natural phrasing and verified sources.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ryugen04/dotfiles --skill writing-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-guide
Source: https://github.com/ryugen04/dotfiles/tree/main/packages/claude/.claude/skills/writing-guide
Command: npx skills add https://github.com/ryugen04/dotfiles --skill writing-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides guidelines for writing natural, readable Japanese technical documentation, avoiding AI-generated artifacts and maintaining consistency.

Core Features & Use Cases

  • Style rules: Enforce readability and tone guidelines (e.g., limit bold usage, avoid colon endings, etc.).
  • Proofreading & reviews: Check for clarity, accuracy, and sources.
  • Practical examples: Provide concrete examples and templates.

Quick Start

Create or review technical documentation by following the style guidelines (e.g., a README or API spec) to ensure natural, human-like Japanese.

Frequently Asked Questions about writing-guide

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

FAQPage Schema
How do I write Japanese technical documentation that doesn't sound AI-generated?

Japanese technical documentation requires following style guidelines that enforce natural readability, such as limiting bold usage, avoiding colon endings, and including version information and concrete code examples. This Skill provides those rules to ensure human-like expression while maintaining consistency across your docs.

What style rules should I follow when writing a Japanese README or API specification?

Apply readability and tone guidelines including limiting bold emphasis, avoiding colon line endings, including version sources, and providing concrete examples. This Skill enforces these style rules to keep technical documentation clear, consistent, and natural-sounding in Japanese.

How do I proofread Japanese technical documentation for clarity and accuracy?

Review documents against style guidelines, verify sources and version information are present, check that examples and code samples are concrete, and ensure the writing reads naturally without AI-generated artifacts. This Skill provides the verification rules and checklist needed for effective proofreading.

Can I use this approach for blog posts and technical explanations in Japanese?

Yes. This Skill applies to any Japanese technical writing—READMEs, API docs, blog posts, and explanations. It ensures natural readability, includes sources and versions, provides concrete examples, and maintains consistent style across all technical content formats.

What's the best way to avoid common AI artifacts when generating Japanese technical content?

Apply structured style rules that enforce human-like tone, include version and source information upfront, use concrete code examples instead of generic descriptions, and review output against a readability checklist. This Skill codifies these practices to systematically eliminate AI-generated phrasing.

Do I need prior proofreading experience to use Japanese documentation style guidelines?

No. This Skill provides concrete style rules and templates for both creation and review, making it accessible whether you're writing from scratch or refining existing docs. It handles the verification checklist so you can focus on content clarity.