Tech Article Polished Writer

Tech Article Polished Writer

Overview

This skill generates clear, professional, and polished Japanese technical articles suitable for enterprise environments, corporate blogs, official documentation, and formal technical publications. It maintains a consistent, authoritative tone with logical structure and professional vocabulary.

When to Use This Skill

Use Polished Writer for:

• Corporate blogs and company technical articles
• Official documentation and technical guides
• Tutorial content for products or services
• Enterprise-level technical content
• Formal publications requiring professional tone
• Content needing consistent polite form (です/ます)

Use Human Tone Writer instead for:

• Personal blogs (Zenn, Qiita, personal sites)
• Casual technical articles with personality
• Content that benefits from conversational style
• Articles targeting individual developers

Workflow

1. Understand Source Material

Accept input in any of these formats:

• Markdown draft with technical content
• Bullet points or structured outline
• Raw technical notes or concepts
• Existing article that needs professionalization

Ask the user: "Please provide the source material for the article (file path or content)"

2. Load Style Guide

CRITICAL: Before generating any article content, read the complete style guide:

references/style-guide-polished-tone.md

This guide contains:

• Forbidden patterns (casual expressions, AI-isms, unprofessional language)
• Consistent polite tone requirements (です/ます)
• Professional vocabulary standards
• Logical structure guidelines
• Code explanation best practices

Do NOT proceed without reading this guide completely.

3. Generate Article

Follow the style guide strictly while generating content:

Critical Requirements (Publication Blockers):

• ZERO casual/slang endings (〜だね。〜じゃん。contracted forms)
• ZERO unprofessional connectors (で、なんか、ぶっちゃけ)
• ZERO AI-isms (robotic repetition, excessive また/さらに)
• ZERO colons (：) in prose before code/lists
• CONSISTENT polite form (です/ます) throughout main text (target: 90%+)
• Valid frontmatter (title, emoji, type, topics, published)

Professional Quality Standards:

• Clear, logical structure with proper headings (H2, H3)
• Introduction states problem and solution clearly
• Conclusion summarizes key points effectively
• Professional vocabulary and standard terminology
• Code explanations include "why" and "how"
• Active voice preference for clarity

4. Save Output

Save the generated article to:

outputs/YYYYMMDD-{topic-slug}.md

Example: outputs/20260110-typescript-advanced-types.md

5. Validation (Optional)

Run validation script to check for forbidden patterns and polite form consistency:

python scripts/validate_article.py outputs/YYYYMMDD-{topic-slug}.md

Usage Examples

Example 1: Corporate blog post

User: "この技術資料を企業ブログ向けの記事にして"

- React 19の新機能紹介
- Server Componentsの利点
- 移行ガイド

Agent: [Loads style guide] → Generates professional article → Saves to outputs/20260110-react-19-server-components.md

Example 2: Official documentation

User: "公式ドキュメント用にpolishedトーンで記事作成"

Agent: [Loads style guide] → Creates formal technical guide → Saves with professional tone

Example 3: Professionalize existing content

User: "このカジュアルな記事をプロフェッショナルに書き直して" + provides draft.md

Agent: [Loads style guide] → Rewrites with polished tone → Saves to outputs/20260110-polished-article.md

Resources

scripts/

• validate_article.py: Validates generated articles against polished tone requirements, forbidden patterns, and professional standards

Usage:

python scripts/validate_article.py <article-path>

references/

• style-guide-polished-tone.md: Complete style guide for generating professional, polished Japanese technical articles. MUST be read before generating any content.