Skill Article Writer

Analyze Claude skills and generate detailed tutorial articles.

What This Skill Does

Meta-skill that transforms any skill into a detailed tutorial:

• Analyzes skill structure and resources

• Generates article outlines

• Creates comprehensive tutorials with examples

• Produces multi-language versions (en, zh, fr)

Use cases:

• Documentation for internal skills

• Tutorials for skill development

• Best practices analysis

• Educational content

Prerequisites

• Local clone of target skill

• Python 3.x (for analysis scripts)

• Write access to create article files

Workflow

Step 1: Understand the Source Skill

• Read the skill's SKILL.md

• Examine bundled resources (scripts/, references/, assets/)

• Identify key workflows

• Note target audience

Output: Understanding of skill's value proposition

Step 2: Analyze Structure

scripts/analyze_skill.py /path/to/skill-name > /tmp/skill-metadata.json

Extracts:

• Directory structure

• YAML frontmatter

• Section headings

• Bundled resources

• Workflow steps

Step 3: Generate Article Outline

scripts/generate_article_outline.py /tmp/skill-metadata.json > /tmp/article-outline.md

Outline structure:

• Introduction (what is this skill?)

• Skill Anatomy (directory structure)

• Technical Deep Dive (how it works)

• Usage Examples (practical demonstrations)

• Best Practices (design principles)

• Integration Patterns (with other skills)

• Conclusion

Step 4: Fill In Content

For each section in the outline:

• Expand bullet points into full paragraphs

• Add code examples where appropriate

• Include MDX components (Callout, Cards, Steps)

• Add source attribution

Step 5: Add Frontmatter

title: Analyzing {Skill Name} description: Deep dive into {skill name} - structure, patterns, and usage author: Your Name date: YYYY-MM-DD lang: en category: development

Step 6: Create Multi-Language Versions

Use article-translator skill to create:

• content/docs/zh/development/{slug}.mdx

• content/docs/fr/development/{slug}.mdx

Step 7: Validate and Publish

• Run MDX validation

• Run build check

• Use skill-article-publisher to commit and push

Article Structure Template

title: Analyzing {Skill Name} description: {Brief description}

Analyzing {Skill Name}

Introduction

{What problem does this skill solve?}

<Callout type="info"> Key insight about the skill </Callout>

Skill Anatomy

Directory Structure

skill-name/ ├── SKILL.md # Main skill definition ├── scripts/ # Helper scripts ├── references/ # Reference documents └── assets/ # Templates, images

Key Components

• SKILL.md: {description}
• scripts/: {description}

How It Works

{Step-by-step explanation of the workflow}

Usage Examples

Example 1: {Use Case}

# Command or code

Best Practices

- {Practice 1}

- {Practice 2}

Integration

{How this skill works with others}

Conclusion

{Summary and next steps}

## Example Output

See `examples/skill-creator-output.md` for a complete example analyzing the skill-creator skill.

## Best Practices

### Content Quality

1. **Be specific**: Use actual code examples, not placeholders
2. **Be practical**: Focus on what readers need to know
3. **Be accurate**: Verify all technical details

### Structure

1. **Lead with value**: Start with what problem the skill solves
2. **Progressive disclosure**: Simple → complex
3. **Scannable**: Use headings, lists, callouts

### MDX Components

```mdx
<Callout type="info">Key information</Callout>

<Steps>
  <Step>First step</Step>
  <Step>Second step</Step>
</Steps>

<CardGroup>
  <Card title="Card 1">Content</Card>
  <Card title="Card 2">Content</Card>
</CardGroup>

Integration with Other Skills

skill-article-writer (this skill)
        ↓
article-translator (translate to zh/fr)
        ↓
mdx-article-publisher (commit & push)

Scripts

- scripts/analyze_skill.py
 - Extract skill metadata

- scripts/generate_article_outline.py
 - Generate article template

References

- references/article-templates.md
 - Templates for different skill types