| name | tech-article-polished-writer |
| description | Generate clear, professional, and polished Japanese technical articles suitable for corporate blogs, official documentation, and technical publications. Use this skill when the user wants to create enterprise-level content with consistent polite tone (です/ます), logical structure, and authoritative voice. Triggers include requests like "polished article", "professional tone", "enterprise blog", "公式ドキュメント", "プロフェッショナルな記事", or when content needs formal technical writing. |
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.
