atman-33/tech-article-humanizer

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.