Blog Content Enhancer

专为 tolearn.blog 设计的博客内容增强技能，通过实时研究、数据支撑和视觉优化提升文章质量。

Core Capabilities

1. Real-time Research (实时研究)

Search for latest statistics, trends, and case studies
Verify claims with authoritative sources
Find relevant quotes from industry experts

2. Content Analysis (内容分析)

Evaluate article structure and flow
Identify gaps in argumentation
Assess readability and engagement

3. Visual Enrichment (视觉增强)

Suggest strategic image placements
Recommend diagram types for concepts
Provide image description templates

4. Persuasion Enhancement (说服力增强)

Add data-backed claims
Include relevant case studies
Strengthen arguments with citations

5. Language Refinement (语言优化)

Convert formal language to conversational tone
Improve sentence flow and transitions
Ensure active voice usage

Commands

`research [topic]`

Search for real-time data and statistics on a topic.

Usage:

/blog-content-enhancer research "AI adoption rates 2025"

Process:

Use WebSearch to find latest data (prioritize 2025-2026 sources)
Extract key statistics and trends
Format findings with proper citations
Return structured research summary

`analyze content [path]`

Evaluate an article and identify improvement opportunities.

Usage:

/blog-content-enhancer analyze content app/blog/posts/my-article.mdx

Analysis Criteria:

Structure Score: Heading hierarchy, section balance
Data Density: Statistics, citations, external references
Visual Score: Image placements, diagram opportunities
Readability: Sentence variety, jargon level
Engagement: Hooks, examples, call-to-actions

Output Format:

## Content Analysis Report

### Overall Score: X/100

### Strengths
- [List identified strengths]

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

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

`enhance article [path]`

Complete enhancement workflow for a blog article.

Usage:

/blog-content-enhancer enhance article app/blog/posts/my-article.mdx

Workflow:

Read & Analyze: Load article, assess quality
Research: Search for relevant data based on topic
Plan Enhancements: Map out data insertion points, image locations
Execute Changes: Apply enhancements while preserving voice
Validate: Check MDX syntax, verify links

`improve language [path]`

Focus on language refinement only.

Usage:

/blog-content-enhancer improve language app/blog/posts/my-article.mdx

Transformations:

Formal → Conversational
Passive → Active voice
Complex → Clear
Add transition phrases
Vary sentence structure

`suggest images [path]`

Analyze article and recommend image placements.

Usage:

/blog-content-enhancer suggest images app/blog/posts/my-article.mdx

Output:

## Image Suggestions

### Position 1: After Introduction
- **Type**: Hero/conceptual image
- **Suggested content**: [Description]
- **Alt text**: [SEO-optimized alt text]

### Position 2: Section "Getting Started"
- **Type**: Diagram/flowchart
- **Suggested content**: [Description]
- **Alt text**: [SEO-optimized alt text]

Enhancement Workflow

┌─────────────────────────────────────────────────────────┐
│            Blog Content Enhancement Workflow            │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  1. Article Analysis                                    │
│     └─ Read MDX → Parse structure → Generate report    │
│                                                         │
│  2. Real-time Research                                  │
│     └─ Extract topics → WebSearch → Compile citations  │
│                                                         │
│  3. Enhancement Planning                                │
│     └─ Map image spots → Plan data points → Mark edits │
│                                                         │
│  4. Content Enhancement                                 │
│     └─ Insert data → Add images → Refine language      │
│                                                         │
│  5. Validation                                          │
│     └─ Check MDX syntax → Verify links → Compare diff  │
│                                                         │
└─────────────────────────────────────────────────────────┘

Research Guidelines

Source Hierarchy

Primary Sources: Official reports, research papers
Industry Reports: Gartner, McKinsey, Statista
Tech Publications: TechCrunch, Ars Technica, The Verge
Developer Resources: Official docs, GitHub stats

Citation Format

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

Freshness Requirements

Strongly Prefer: 2025-2026 data
Acceptable: 2024 data if more recent unavailable
Avoid: Pre-2023 data unless historically relevant

Visual Guidelines

Image Template (MDX Format)

<figure className="my-8">
  <img
    src="/images/[filename].png"
    alt="[Descriptive alt 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">
    [Figure caption explaining the image]
  </figcaption>
</figure>

Image Placement Rules

After Introduction: Set context visually
Complex Concepts: Before or after explanation
Code Examples: Screenshot of result if applicable
Conclusion: Summarizing graphic or CTA image

Alt Text Best Practices

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

Language Patterns

Formal → Conversational Conversions

Formal	Conversational
"It is important to note that..."	"Here's the key thing:"
"This enables users to..."	"This lets you..."
"The implementation demonstrates..."	"This shows how..."
"Subsequently, one must..."	"Next, you'll need to..."
"It should be mentioned that..."	"Worth noting:"

Transition Phrases

Addition:

What's more, ...
On top of that, ...
Here's another thing: ...

Contrast:

That said, ...
But here's the catch: ...
On the flip side, ...

Example:

Take [X] for instance: ...
Here's a real example: ...
Case in point: ...

Conclusion:

The bottom line: ...
So what does this mean? ...
Here's the takeaway: ...

Quality Checklist

Before completing enhancement, verify:

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
Placement enhances understanding
MDX syntax is correct

Language & Style

Active voice predominates
Sentences vary in length
Technical jargon is explained
Transitions are smooth

Technical

MDX compiles without errors
Internal links work
No broken external links
Metadata is complete

Reference Files

For research sources: See references/research-sources.md
For visual guidelines: See references/visual-guidelines.md
For language patterns: See references/language-patterns.md

Integration with Other Skills

With ai-blog-writer

Use ai-blog-writer for initial draft creation
Apply blog-content-enhancer for quality improvement
Flow: Write → Enhance → Publish

With pseo-engine

Use pseo-engine for SEO optimization
Use blog-content-enhancer for content quality
Flow: Research → Write → Enhance → Optimize SEO