tech-article-humanizer
Transform technical article drafts or source materials into human-like, high-quality Japanese technical articles. Use this skill when the user wants to generate, rewrite, or humanize technical articles (especially about TypeScript, JavaScript, React, or frontend topics) following specific human-writing patterns and style guidelines. Triggers include requests like "記事を人間風に", "tech article を生成", "humanize this article", or providing article source materials.
When & Why to Use This Skill
The Tech Article Humanizer is a specialized Claude skill designed to transform technical drafts and raw notes into high-quality, human-like Japanese technical articles. By strictly following a professional style guide and incorporating authenticity markers like code evolution and ecosystem context, it eliminates robotic AI patterns to produce engaging content for platforms like Qiita or Zenn, specifically optimized for frontend topics like TypeScript, JavaScript, and React.
Use Cases
- Converting rough Markdown outlines or bullet points into comprehensive, publication-ready Japanese technical blog posts that sound like they were written by an experienced developer.
- Humanizing existing AI-generated technical drafts to ensure they meet the natural tone, polite form distribution, and stylistic nuances expected by the Japanese developer community.
- Refining technical documentation by adding developer-centric context, such as GitHub references and community mentions, while automatically validating the content against forbidden writing patterns.
| name | tech-article-humanizer |
|---|---|
| description | Transform technical article drafts or source materials into human-like, high-quality Japanese technical articles. Use this skill when the user wants to generate, rewrite, or humanize technical articles (especially about TypeScript, JavaScript, React, or frontend topics) following specific human-writing patterns and style guidelines. Triggers include requests like "記事を人間風に", "tech article を生成", "humanize this article", or providing article source materials. |
Tech Article Humanizer
Overview
This skill transforms technical article drafts into authentic, human-like Japanese technical articles that are indistinguishable from content written by experienced developers. It follows a comprehensive style guide that eliminates AI writing patterns and produces natural, engaging technical content.
Workflow
1. Understand Source Material
Accept input in any of these formats:
- Markdown draft with rough structure
- Bullet points or outline
- Raw notes or technical concepts
- Existing article that needs humanization
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-human-tone.md
This guide contains:
- Forbidden patterns that must have ZERO violations
- Polite form (です/ます) distribution requirements
- Authenticity markers and human-like writing patterns
- Technical accuracy standards
- Pre-submission checklist
Do NOT proceed without reading this guide completely.
3. Generate Article
Follow the style guide strictly while generating content:
Critical Requirements (Publication Blockers):
- ZERO sentence-ending contracted forms (てる。てた。てます。)
- ZERO paragraph-initial "で、"
- ZERO colons (：) in prose before code/lists
- MINIMUM 15+ です/ます sentence endings
- TARGET 45-60% です/ます distribution
- Valid frontmatter (title, emoji, type, topics, published)
Authenticity Markers (for 8.0+ quality):
- Show code evolution (bug → fix, V1 → V2)
- Include 2-3 unresolved elements
- Add ecosystem context (GitHub refs, community mentions)
- Vary depth dramatically (15 para on favorite topic, 2 sentences on boring)
- Maximum 6-7 H2 sections
4. Save Output
Save the generated article to:
outputs/YYYYMMDD-{topic-slug}.md
Example: outputs/20260110-typescript-const-parameters.md
5. Validation (Optional)
Run validation script to check for forbidden patterns:
python scripts/validate_article.py outputs/YYYYMMDD-{topic-slug}.md
Usage Examples
Example 1: From bullet points
User: "これを元に技術記事を作成してください"
- TypeScript 5.0の新機能
- const type parametersについて
- 使い方と利点
Agent: [Loads style guide] → Generates full article → Saves to outputs/20260110-typescript-const-parameters.md
Example 2: Humanize existing draft
User: "この記事を人間風にリライトして" + provides draft.md
Agent: [Loads style guide] → Rewrites following human patterns → Saves to outputs/20260110-rewritten-article.md
Example 3: With validation
User: "記事を生成して、バリデーションもお願い"
Agent: [Generate article] → Saves output → Runs validation → Reports results
Resources
scripts/
- validate_article.py: Validates generated articles against forbidden patterns and style requirements
Usage:
python scripts/validate_article.py <article-path>
references/
- style-guide-human-tone.md: Complete style guide for generating human-like Japanese technical articles. MUST be read before generating any content.