AI Blog Studio

Complete blog writing and enhancement toolkit for tolearn.blog. 专为 tolearn.blog 设计的统一博客创作工具，整合写作、研究、SEO和内容增强功能。

Quick Start

Command	Description
`write [topic]`	Full workflow: research → outline → draft → enhance → validate
`enhance [path]`	Enhance existing article with data, visuals, language refinement
`analyze [path]`	Quality analysis only, with scoring and suggestions
`research [topic]`	Search for latest data and statistics with citations

Capabilities

1. Writing (写作)

4 article templates (Tutorial, Comparison, Explainer, List)
Structured outlines with clear sections
Voice guidelines for conversational yet professional tone
Code examples with best practices

2. Research (研究)

Real-time WebSearch for latest data (2025-2026)
Source hierarchy with authority levels
Citation formatting with proper attribution
Trend and statistic discovery

3. SEO Optimization (SEO优化)

Title optimization (50-60 characters)
Meta description guidelines
Keyword strategy (primary, secondary, long-tail)
Schema markup for tutorials
Internal/external linking strategy

4. Enhancement (增强)

Language refinement (formal → conversational)
Data-backed claims insertion
Visual suggestions with MDX templates
Transition phrase optimization

5. Visual Content (视觉内容) ✨

Mermaid图表自动生成: 根据内容类型推荐合适的图表 (流程图、架构图、时序图、状态图、类图)
免费图库搜索: 推荐Unsplash/Pexels/Pixabay等图库，提供搜索关键词策略
AI图片提示词: DALL-E/Midjourney提示词模板 (Hero图、技术架构、对比图、数据可视化)

6. Validation (验证)

SEO checklist verification
MDX syntax validation
Quality scoring (structure, data, visuals, readability)
Pre-publish checklist

Complete Workflow

┌─────────────────────────────────────────────────────────────┐
│              AI Blog Studio - Complete Workflow             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. RESEARCH (研究)                                          │
│     └─ WebSearch → Collect latest data → Format citations   │
│                                                             │
│  2. OUTLINE (大纲)                                           │
│     └─ Select template → Plan structure → Define key points │
│                                                             │
│  3. DRAFT (初稿)                                             │
│     └─ Apply style guide → Add code examples → Insert data  │
│                                                             │
│  4. ENHANCE (增强)                                           │
│     └─ Language polish → Image suggestions → Internal links │
│                                                             │
│  5. VALIDATE (验证)                                          │
│     └─ SEO check → MDX syntax → Quality scoring             │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Commands

`write [topic]`

Create a complete blog post from scratch using the full workflow.

Usage:

/ai-blog-studio write "Building AI Agents with Claude"

Process:

Research Phase: Use WebSearch to gather latest statistics, trends, and case studies
Outline Phase: Generate structured outline based on best-fit template
Draft Phase: Write content following style guide and voice guidelines
Enhance Phase: Add data citations, suggest images, refine language
Validate Phase: Run SEO checks, verify MDX syntax, generate quality report

Output: Complete MDX article ready for publishing

`enhance [path]`

Enhance an existing article with research, data, and polish.

Usage:

/ai-blog-studio enhance app/blog/posts/my-article.mdx

Process:

Read and analyze current article
Search for relevant data to support claims
Identify image placement opportunities
Refine language for engagement
Validate all changes

`analyze [path]`

Generate a quality report without making changes.

Usage:

/ai-blog-studio analyze app/blog/posts/my-article.mdx

Output:

## Content Analysis Report

### Overall Score: X/100

### Scores by Category
- Structure: X/25
- Data Density: X/25
- Visual Elements: X/25
- Language Quality: X/25

### Strengths
- [Identified strengths]

### Improvement Opportunities
1. [Specific suggestion with location]
2. [Specific suggestion with location]

### Recommended Actions
- [ ] Add statistic at [section]
- [ ] Insert image after [paragraph]
- [ ] Strengthen conclusion with CTA

`research [topic]`

Search for real-time data and compile research summary.

Usage:

/ai-blog-studio research "AI adoption rates 2026"

Process:

Use WebSearch with optimized queries
Prioritize 2025-2026 sources
Extract key statistics and quotes
Format with proper citations

Output:

## Research Summary: [Topic]

### Key Statistics
- [Statistic 1] — [Source](URL) (2026)
- [Statistic 2] — [Source](URL) (2025)

### Expert Quotes
> "[Quote]" — [Name], [Title] at [Company]

### Trends & Insights
1. [Trend 1]
2. [Trend 2]

### Recommended Sources
- [Source 1](URL) - [Why it's relevant]
- [Source 2](URL) - [Why it's relevant]

Writing Guidelines

Target Audience

English-speaking developers and tech enthusiasts in US/Europe
Skill levels: beginner to intermediate
Interest areas: AI tools, LLMs, practical programming tutorials

Voice & Tone

Conversational but professional
First-person perspective ("I discovered...", "Let me show you...")
Avoid overly formal academic language
Use humor sparingly and appropriately
Be direct and actionable

Content Structure

1. Hook (1-2 sentences) - Grab attention with a problem or question
2. Introduction (2-3 paragraphs) - Context and what reader will learn
3. Main Content - Step-by-step with code examples
4. Practical Tips - Real-world applications
5. Conclusion - Summary + Call to action

Code Examples

Always explain BEFORE showing code
Include comments in code
Show complete, runnable examples
Specify language for syntax highlighting
Break long code into digestible chunks

Research Guidelines

Source Hierarchy

Priority	Source Type	Examples
1	Primary/Official	Anthropic Research, OpenAI Blog, Google AI
2	Industry Reports	Gartner, McKinsey, Statista
3	Tech Publications	TechCrunch, Ars Technica, The Verge
4	Developer Resources	Official docs, GitHub stats, Stack Overflow

Freshness Requirements

2026        ████████████ Strongly Preferred
2025        ██████████   Preferred
2024        ██████       Acceptable
Pre-2024    ████         Only for historical context

Citation Format

According to [Source Name](URL), [statistic or quote]. (Published: Month Year)

SEO Guidelines

Title Optimization

Length: 50-60 characters
Format: [Action Verb] + [Topic] + [Benefit/Year]
Power words: How, Why, Guide, Best, Ultimate, Easy

Meta Description

Length: 150-160 characters
Include primary keyword naturally
End with call-to-action or benefit

Keyword Strategy

Type	Placement
Primary	Title, H1, first paragraph, URL slug
Secondary	H2 headings
Long-tail	Subheadings, body content
LSI	Natural body content

Schema Markup (for tutorials)

{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "How to [Action]",
  "step": [
    {"@type": "HowToStep", "name": "Step 1", "text": "..."}
  ]
}

Visual Guidelines

Image Placement Rules

Position	Purpose	Image Type
After intro	Set context	Hero, conceptual
Before complex section	Prepare reader	Diagram, overview
After explanation	Reinforce	Example, screenshot
At data points	Visualize stats	Chart, infographic
Before conclusion	Summarize	Summary graphic

MDX Image Template

<figure className="my-8">
  <img
    src="/images/[filename].png"
    alt="[Descriptive text for accessibility and SEO]"
    className="w-full h-auto rounded-lg shadow-lg"
  />
  <figcaption className="mt-2 text-center text-sm text-gray-600 dark:text-gray-400">
    [Caption explaining the image]
  </figcaption>
</figure>

Alt Text Best Practices

Describe content, not appearance
Include relevant keywords naturally
Length: 50-125 characters
Be specific: "Dashboard showing API response times" not "Screenshot"

Mermaid图表 (自动生成)

根据内容类型自动建议图表代码：

内容类型	图表类型	示例场景
步骤说明	flowchart TD	教程、配置指南
系统设计	flowchart LR + subgraph	架构概览
API交互	sequenceDiagram	请求流程
状态变化	stateDiagram-v2	生命周期
数据结构	classDiagram	类型定义

免费图库

图库	特点	推荐用途
Unsplash	高质量摄影	Hero图、背景
Pexels	综合素材	通用配图
unDraw	技术插画	技术博客

AI图片提示词模板

提供按场景分类的DALL-E/Midjourney提示词：

Hero概念图: 科技简约风格，渐变色彩
技术架构图: 等距立体风格，标注组件
对比图: 分屏设计，对比色彩
数据可视化: 抽象数据流，未来感

详见 image-guidelines.md

Quality Checklist

Before Publishing

Content & Structure

Title is 50-60 characters and compelling
Meta description is 150-160 characters
First paragraph hooks the reader
Headings follow H2 → H3 hierarchy
Reading time is appropriate (5-10 min ideal)

Code & Technical

All code examples are tested and working
Code blocks specify language
Technical jargon is explained on first use

Data & Citations

All statistics have sources
Sources are from 2024-2026
Links are valid and accessible
Quotes are accurately attributed

Visual Elements

Images have descriptive alt text
Figures have captions
Strategic image placement (every 300-500 words)

SEO & Links

Internal links to 2-3 related posts
Descriptive anchor text (not "click here")
Call-to-action in conclusion

Language

Active voice predominates (>80%)
Sentences vary in length
Tone is conversational and professional
No grammar/spelling errors

Reference Files

Category	File	Description
Writing	templates.md	4 article templates
Writing	style-guide.md	Voice, tone, language patterns
Writing	code-examples.md	Code formatting best practices
SEO	seo-guide.md	Complete SEO reference
Research	sources.md	Source hierarchy and citations
Visuals	image-guidelines.md	Image templates and alt text

Scripts

Script	Purpose	Usage
`generate_outline.py`	Generate structured outlines	`python scripts/generate_outline.py tutorial "Topic"`
`seo_check.py`	Analyze SEO of markdown files	`python scripts/seo_check.py path/to/article.md`

Integration with Other Skills

With pseo-engine

Use ai-blog-studio for content creation
Use pseo-engine for advanced SEO analysis and programmatic pages
Flow: Research → Write → Enhance → Optimize SEO → Publish