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.

tech-article-humanizer