Zenn Article Writer

Overview

Write technical articles for Zenn that match Oikon's writing style and structure. This skill provides comprehensive guidelines for creating engaging technical content with a casual yet professional tone, clear structure, and practical examples.

When to Use This Skill

Use this skill when:

• •Writing articles about AI tools (Claude Code, Codex, CodeRabbit, etc.)
• •Explaining development workflows and practical implementations
• •Describing tool integrations and ecosystem setups
• •Reporting on updates, new features, or version releases
• •Creating technical reports with hands-on experience
• •Needing to match Oikon's established writing style and tone

Article Writing Process

Follow this workflow to create well-structured articles:

1. Define Article Type and Scope

Identify which pattern best fits the article:

• •Workflow explanation: Step-by-step processes with tools and services
• •Update/feature explanation: Version releases and new functionality
• •Tool integration: Connecting multiple tools and services
• •Tool review: Introduction and evaluation of new tools

2. Gather Required Information

Collect necessary materials before writing:

• •Personal experience and background context
• •Tool/service names and links
• •Screenshots, diagrams, or workflow visualizations
• •Code examples, commands, and configuration files
• •Reference links to official documentation
• •Related tweets, slides, or external content

3. Create Article Structure

Outline the article based on the selected pattern (see references/article-structure.md):

• •Start with personal introduction and motivation
• •Present overall workflow or concept with visual aids
• •Break down into clear, numbered steps
• •Include concrete examples and commands
• •Provide tips, warnings, and personal insights
• •Conclude with summary and key takeaways

4. Write with Oikon's Style

Apply the distinctive writing characteristics (see references/writing-style.md):

• •Use casual but professional tone
• •Share personal experiences and trial-and-error processes
• •Include humble acknowledgments of limited experience
• •Provide multiple options with personal comparisons
• •Add screenshots and visual aids generously
• •Present concrete commands and code examples
• •Emphasize practical usability

5. Add Metadata and Closing

Complete the article with proper metadata and closing sections:

• •Set appropriate frontmatter (title, emoji, topics, publish date)
• •Write concise summary revisiting key points
• •Include X (Twitter) follow invitation
• •List all referenced links in bibliography

Writing Guidelines

Article Structure Patterns

Reference references/article-structure.md for detailed structure patterns:

• •Workflow explanation pattern: Overall workflow → Step details → Summary
• •Update explanation pattern: Overview → Feature details → Overall impression
• •Tool integration pattern: Overall flow → Prerequisites → Setup steps → Usage
• •Tool review pattern: Overview → Features → Usage examples → Comparison → Summary

Writing Style Characteristics

Reference references/writing-style.md for detailed style guidelines:

• •Casual and approachable tone: Technical content with conversational language
• •Experience-based introduction: Start with personal background and context
• •Humble stance: Acknowledge limited experience and respect readers
• •Clear structure: Use ## and ### headings for scannable content
• •Visual aids: Include screenshots, diagrams, and workflow visualizations
• •Concrete examples: Provide actual commands, code, and configuration
• •Personal insights: Share comparisons, opinions, and lessons learned

Zenn-Specific Formatting

Use Zenn's markdown features effectively:

• •Frontmatter with title, emoji, type, topics, published, published_at
• •:::message blocks for important notes and warnings
• •Image sizing: ![alt text](/images/folder/file.png =400x)
• •External link embedding (tweets, slides, etc.)
• •Code blocks with language specification

Templates and References

Article Template

Use assets/zenn-template.md as the starting point for new articles. Copy this template and customize:

• •Update frontmatter with appropriate metadata
• •Fill in personal introduction and background
• •Structure content based on selected pattern
• •Add actual content, examples, and visuals
• •Complete summary and closing sections

Style Reference

Consult references/writing-style.md for:

• •Detailed tone and voice guidelines
• •Structural conventions and best practices
• •Do's and Don'ts for writing
• •Image and link handling
• •Section-specific writing approaches

Structure Reference

Consult references/article-structure.md for:

• •Complete article pattern templates
• •Section-by-section writing guidance
• •Example phrases and structures
• •Article writing checklist

Example Articles

Review references/example-articles.md for:

• •Real excerpts from Oikon's published articles
• •Pattern-specific examples
• •Introduction and conclusion variations
• •Concrete demonstration of style guidelines

Key Principles

Remember these core principles when writing:

1. •Share real experiences: Base content on actual trials and implementations
2. •Provide actionable guidance: Include concrete steps readers can follow
3. •Balance casual and professional: Maintain approachability without sacrificing quality
4. •Use visuals generously: Support explanations with screenshots and diagrams
5. •Show comparisons: Present multiple approaches with personal assessments
6. •Acknowledge limitations: Be honest about experience level and constraints
7. •Enable reproducibility: Include all necessary commands, configs, and links
8. •Respect the reader: Assume expertise while providing helpful context

Resources

references/writing-style.md

Comprehensive documentation of Oikon's writing style, including tone, structure, explanatory approaches, and detailed Do's and Don'ts. Load this when needing guidance on voice, formatting conventions, or stylistic decisions.

references/article-structure.md

Complete article structure patterns for different article types, with section-by-section templates and writing guidance. Reference this when planning article organization or needing structure-specific examples.

references/example-articles.md

Real excerpts from Oikon's published articles demonstrating each pattern type. Consult this when needing concrete examples of introductions, explanations, or closing sections.

assets/zenn-template.md

Blank article template with proper frontmatter and structural skeleton. Copy this file as the starting point for new articles and fill in with actual content following the style guidelines.