skill-article-writer
Generate comprehensive analysis articles from Claude skills. This skill transforms any skill from the Anthropic repository into a detailed tutorial with explanations, best practices, and usage examples.
What This Skill Does
skill-article-writer is a meta-skill that:
- Analyzes skill structure and bundled resources
- Generates detailed article outlines
- Creates comprehensive tutorials with code examples
- Produces multi-language versions (en, zh, fr)
- Follows proven documentation patterns
Use cases:
- Creating documentation for internal skills
- Writing tutorials for skill development
- Analyzing best practices from example skills
- Generating educational content for Claude users
Skills vs. Articles
- Skills: Executable workflows that extend Claude's capabilities
- Articles: Educational content that explains how skills work
- This Skill: Bridges the gap by analyzing skills and creating articles
Prerequisites
Before using this skill, you must have:
- Access to Anthropic skills repository:
github.com/anthropics/skills
- Local clone of target skill: The skill must be available locally
- Python 3.x: Required for analysis scripts
- Write access: Ability to create article files in your project
How The Skill Works
Progressive Analysis
This skill uses a three-stage analysis process:
Structure Analysis (analyze_skill.py)
- Examines directory structure
- Parses SKILL.md metadata
- Identifies bundled resources
- Generates comprehensive metadata
Outline Generation (generate_article_outline.py)
- Creates article structure
- Plans section content
- Identifies code examples
- Generates markdown template
Content Creation
- Fills in outline with detailed analysis
- Adds practical examples
- Creates multi-language versions
- Validates MDX syntax
Output Structure
Each generated article follows this structure:
1. Introduction (what is this skill?)
2. Skill Anatomy (directory structure)
3. Technical Deep Dive (how it works)
4. Usage Examples (practical demonstrations)
5. Best Practices (design principles)
6. Integration Patterns (with other skills)
7. Troubleshooting (common issues)
8. Conclusion and Next Steps
Directory Structure
The skill-article-writer includes helper scripts for automation:
skill-article-writer/
├── SKILL.md # This file
├── scripts/
│ ├── analyze_skill.py # Analyze skill structure
│ └── generate_article_outline.py # Generate article template
├── references/
│ └── article-templates.md # Template patterns for different skill types
└── examples/
└── skill-creator-output.md # Example: analysis of skill-creator
The 7-Step Article Creation Process
Step 1: Understand the Source Skill
Purpose: Gain deep understanding of the skill's structure and purpose
Actions:
- Read the skill's SKILL.md: Understand what problem it solves
- Examine bundled resources: Scripts, references, and assets
- Identify key workflows: How does the skill accomplish its goals?
- Note the target audience: Who is this skill designed for?
Output: Comprehensive understanding of the skill's value proposition
Example: When analyzing skill-creator, we identified:
- Problem solved: Manual skill creation is error-prone
- Key workflows: 6-step creation process with validation
- Target audience: Developers creating Claude skills
- Value proposition: Systematic approach ensures quality and consistency
Step 2: Analyze Structure and Extract Metadata
Purpose: Extract structured information for article generation
Run analysis script:
scripts/analyze_skill.py /path/to/skill-name > /tmp/skill-metadata.json
What the script extracts:
- Directory structure and file organization
- YAML frontmatter (name, description, etc.)
- Section headings and content structure
- Bundled resources inventory
- Commands and usage patterns
- Workflow steps
Output: JSON metadata file with structured skill information
Key insight: This metadata serves as the single source of truth for article generation
Step 3: Generate Article Outline
Purpose: Create a structured outline that covers all important aspects
Run outline generator:
scripts/generate_article_outline.py /tmp/skill-metadata.json > /tmp/article-outline.md
The outline includes:
- Complete article structure with all sections
- Calls to action for expansion
- Component placeholders (Callouts, Cards, Steps)
- Source attribution blocks
- Appendix for detailed resource listings
Design considerations:
- Follows proven article structure from successful skill analyses
- Adapts section depth based on skill complexity
- Includes both overview and deep-dive sections
- Provides practical examples and use cases
Output: Comprehensive outline (150-200 lines) covering:
- Introduction and overview
- Technical deep dive
- Usage examples
- Best practices
- Troubleshooting
- Conclusion
Step 4: Research and Expand Content
Purpose: Transform the outline into a detailed, informative article
Content expansion process:
Fill in section details:
- Explain each concept thoroughly
- Add code snippets and examples
- Include practical demonstrations
- Provide real-world use cases
Add visual elements:
- Insert
<Callout type="info|warn|tip"> for important points
- Use
<Cards> and <Card> for related concepts
- Add
<Steps> and <Step> for procedural content
- Include
<Files>, <Folder>, <File> for directory structures
Create practical examples:
- Walk through a complete example
- Show before and after
- Include expected output
- Highlight key takeaways
Add cross-references:
- Link to related skills
- Reference external documentation
- Connect to broader concepts
Writing style: Use imperative/infinitive form throughout
- ❌ Wrong: "You should run the script"
- ✅ Right: "Run the script"
Output: Complete article draft in English (3000-4000 words)
Step 4.5: Generate Article Cover Illustration
Purpose: Automatically create a modern, theme-relevant SVG cover illustration for the skill analysis article.
Why this matters:
- Visual appeal increases engagement and readability
- Consistent illustration style across all skill documentation
- Saves time compared to manual design
- Automatically matches skill theme and technical domain
Process:
Invoke the philosophical-illustrator skill:
- This skill generates modern, colorful SVG illustrations for technical content
- Automatically selects color palette based on skill domain
- Creates theme-relevant visual metaphors
Prepare illustration context from skill analysis:
Skill Name: {skill-name}
Article Title: {article-title}
Main Topic: {skill's main purpose}
Key Concepts: {extracted from Step 1 and Step 3}
Technical Domain: {development/data/ai-ml/testing/etc.}
Domain-to-Category Mapping (for color palette selection):
| Skill Domain |
Category |
Palette |
Colors |
| Code/Development |
development |
Pink-Purple |
#C67B9B, #B8789E, #A97BA1 |
| AI/ML/Agents |
ai-ml |
Pink-Purple |
#C67B9B, #B8789E, #A97BA1 |
| Data Processing |
data |
Beige-Neutral |
#C9BFA8, #D4CAAF, #B8AD98 |
| Testing/QA |
development |
Blue |
#5B8FB9, #6B9BC4, #7AA5C8 |
| DevOps/Infrastructure |
devops |
Green-Olive |
#6B7F64, #758C6E, #607360 |
| Security |
security |
Blue |
#5B8FB9, #6B9BC4, #7AA5C8 |
| Design/UI |
design |
Orange-Coral |
#D17B5C, #C88860, #B87A5D |
| General/Multi-purpose |
content |
Multi-topic |
#CA8760, #D17B5C, #B87A5D |
Generate SVG illustration:
- Use the Skill tool to invoke philosophical-illustrator
- Pass skill name, domain, and key concepts
- The skill will generate a 800x450px SVG with theme-relevant imagery
- For skill analysis articles, focus on visual metaphors that represent:
- Workflow automation (gears, connections, flow diagrams)
- Code structure (brackets, files, hierarchies)
- Problem-solving (lightbulbs, tools, transformations)
Save illustration:
mkdir -p "public/images/docs/{article-slug}"
# Save SVG output to:
# public/images/docs/{article-slug}/cover.svg
Update frontmatter reference:
- Add to frontmatter:
image: /images/docs/{article-slug}/cover.svg
- This field will be used by Fumadocs for article preview cards
- Image appears in:
- Article header
- Card previews in navigation
- Social media sharing (og:image)
Example invocation:
Use the philosophical-illustrator skill to generate a cover illustration:
Skill: skill-creator
Article Title: "Skill Creator Deep Dive: Systematic Approach to Building Claude Skills"
Domain: development
Key Concepts: Progressive disclosure, validation, bundled resources, 6-step process
Description: Analysis of skill-creator, a meta-skill for creating high-quality Claude skills
Please create a modern SVG illustration with:
- Pink-Purple color palette (development domain)
- Visual elements: code brackets, file structure icons, workflow connections, gears
- Metaphors: building blocks, systematic process, quality validation
- Modern, friendly aesthetic
- 800x450px dimensions
Output:
- SVG file saved to
public/images/docs/{slug}/cover.svg
- Frontmatter updated with
image field
- Illustration ready for all language versions (reused across en, zh, fr)
Fallback:
- If illustration generation fails, continue without image
- Log warning in summary report
- Article still functions normally (image is optional)
Note: The same cover image is used for all language versions of the article, as visual metaphors are language-agnostic.
Step 5: Create Multi-Language Versions
Purpose: Make the article accessible to international audiences
CRITICAL: Terms to Preserve (DO NOT TRANSLATE)
Certain terms must remain in English as they are:
- Product/Brand Names: Claude, Anthropic, Claude.ai, Claude Code
- Technical Concepts/Features: Skills, Projects, MCP, Agent, SubAgent
- Specific Tools: GitHub, Google Drive, Slack, Excel
- Framework/Technology Names: React, Python, Node.js, TypeScript
- Standard Acronyms: API, SDK, AI, ML, RAG, UI, UX
- Code Examples: Variable names, function names, class names
Translation Instruction:
Translate the following to {language_name}, but PRESERVE these terms in English:
- Claude, Anthropic, Skills, Projects, MCP, Agent, SubAgent
- GitHub, Google Drive, Slack, Excel
- React, Python, Node.js, TypeScript
- API, SDK, AI, ML, RAG, UI, UX
- All code identifiers (variable/function/class names)
Why: These are proper names, brand names, or universal technical terms.
Translating them would confuse readers who expect the standard English terms.
Example of CORRECT translation:
English: "Claude's Skills feature helps agents work better"
Chinese: "Claude 的 Skills 功能帮助 agents 更好地工作" (NOT: "克劳德的技能功能帮助代理更好地工作")
Example of CORRECT translation:
English: "Use the React component with Node.js"
French: "Utilisez le composant React avec Node.js" (NOT: "Utilisez le composant Réagir avec Noeud.js")
Translation Process
For each target language (en, zh, fr):
Prepare content for translation:
- Combine title, description, and main content
- Ensure code blocks are clearly marked
- Keep image references intact
- Mark terms to preserve (see list above)
Request translation:
- Ask for professional translation to the target language
- Specify that this is technical documentation
- Emphasize the need to preserve Markdown formatting and code blocks
- CRITICAL: List all terms that must NOT be translated (from the preserve list above)
Example request format:
Please translate the following article to Chinese (zh).
This is technical documentation - preserve all Markdown syntax, code blocks,
and image references exactly as they appear.
CRITICAL: DO NOT translate these terms - keep them in English:
- Claude, Anthropic, Skills, Projects, MCP, Agent, SubAgent, Subagents
- GitHub, Google Drive, Slack, Excel
- React, Python, Node.js, TypeScript, JavaScript
- API, SDK, AI, ML, RAG, UI, UX, REST, HTTP
- All variable names, function names, and class names in code blocks
Why preserve: These are proper names, brand names, or universal technical terms.
Translating them would confuse readers.
Example correct translation:
WRONG: "克劳德的技能功能帮助代理更好地工作"
CORRECT: "Claude 的 Skills 功能帮助 agents 更好地工作"
Article to translate:
[Article content here]
Translation will automatically apply:
- Professional translation quality (via translator skill)
- Preserves specified English terms in all languages
- Preservation of all Markdown syntax
- Code blocks remain unchanged (including identifiers)
- Image references stay the same (paths unchanged)
- Heading hierarchy maintained
- Technical terms handled appropriately for target language
- Natural, fluent target language text
Language-specific handling:
- Chinese (zh): Simplified Chinese, technical terms stay in English when appropriate
- Format: English term with normal text (e.g., "Skills 功能" not "技能功能")
- No extra spaces needed around English terms
- French (fr): Standard French technical terminology, formal tone
- English terms remain in original form
- English (en): Clear, professional US English
Quality considerations:
- Translation preserves the original meaning and intent
- Technical accuracy is maintained
- Content reads naturally in the target language
- Format and structure remain identical to source
Save translations:
- Save original English version first
- Then save each translated version
- Maintain consistent file structure across all languages
Output: Three complete article versions (en, zh, fr)
Step 6: Create/Update meta.json for All Languages
Purpose: Ensure proper sidebar navigation with localized titles for all languages
CRITICAL: Create proper meta.json files for sidebar navigation with localized titles.
Load reference files:
references/category-translations.json - Get translated category names
references/category-icons.json - Get appropriate icons
For each language (en, zh, fr):
Create/Update category meta.json: content/docs/{lang}/{category}/meta.json
{
"title": "{translated_category_name}",
"icon": "{category_icon}",
"pages": ["{article-slug}", "..."],
"defaultOpen": false
}
Example for ai-ml category:
English (content/docs/en/ai-ml/meta.json):
{
"title": "AI & Machine Learning",
"icon": "Brain",
"pages": ["{article-slug}", "..."],
"defaultOpen": false
}
Chinese (content/docs/zh/ai-ml/meta.json):
{
"title": "AI 与机器学习",
"icon": "Brain",
"pages": ["{article-slug}", "..."],
"defaultOpen": false
}
French (content/docs/fr/ai-ml/meta.json):
{
"title": "IA et Apprentissage Automatique",
"icon": "Brain",
"pages": ["{article-slug}", "..."],
"defaultOpen": false
}
Handling existing meta.json:
- If file exists, read current
pages array
- Ask user: "Where to add new article? (1: top, 2: bottom, 3: alphabetical)"
- Preserve other user customizations (icon, defaultOpen, etc.)
- If
pages array exists, insert article slug; if not, create with ["{slug}", "..."]
Update/Create root meta.json: content/docs/{lang}/meta.json
- Check if category is listed in root
pages array
- If not, ask user: "Add '{category}' to root navigation? (yes/no)"
- If yes, ask: "Where to add? (1: top, 2: bottom, 3: after specific item)"
Example root meta.json:
{
"title": "Documentation",
"pages": [
"index",
"getting-started",
"---[Book]Categories---",
"ai-ml",
"development",
"data",
"..."
]
}
Translation mapping for all 8 categories:
| Category |
English |
Chinese |
French |
| ai-ml |
AI & Machine Learning |
AI 与机器学习 |
IA et Apprentissage Automatique |
| development |
Development |
开发 |
Développement |
| data |
Data |
数据 |
Données |
| design |
Design |
设计 |
Design |
| content |
Content |
内容 |
Contenu |
| business |
Business |
商业 |
Affaires |
| devops |
DevOps |
DevOps |
DevOps |
| security |
Security |
安全 |
Sécurité |
Icon mapping for categories:
| Category |
Icon |
Alternative Icons |
| ai-ml |
Brain |
Cpu, Zap, Sparkles |
| development |
Code |
Terminal, Braces, FileCode |
| data |
Database |
BarChart, PieChart, TrendingUp |
| design |
Palette |
Paintbrush, Layers, Layout |
| content |
FileText |
BookOpen, Book, FileEdit |
| business |
Briefcase |
TrendingUp, DollarSign, Users |
| devops |
Server |
Cloud, Container, GitBranch |
| security |
Shield |
Lock, ShieldCheck, Key |
Important Notes:
- Always create meta.json for ALL 3 languages (en, zh, fr), not just English
- Use localized titles from the translation mapping
- Use the
... syntax to auto-include other pages: ["featured-article", "..."]
- Never hardcode English titles in non-English meta.json files
- Preserve user's existing customizations when updating
Output: meta.json files created/updated for all languages with proper navigation structure
Step 7: Package and Validate
Purpose: Ensure articles are ready for publication
Validation checklist:
✅ Content validation:
✅ Build validation:
✅ Quality checks:
✅ Multi-language verification:
Output: Production-ready articles in three languages
Expected file structure:
content/docs/
├── en/{category}/
│ ├── meta.json (English category title)
│ └── {article-slug}.mdx
├── zh/{category}/
│ ├── meta.json (Chinese category title)
│ └── {article-slug}.mdx
└── fr/{category}/
├── meta.json (French category title)
└── {article-slug}.mdx
Summary report template:
✅ Article Creation Complete!
📄 Article: {title}
🔗 Source Skill: {skill-name}
📁 Category: {category}
🏷️ Tags: {tag1, tag2, tag3, ...}
📝 Files Created:
✅ en: content/docs/en/{category}/{slug}.mdx
✅ zh: content/docs/zh/{category}/{slug}.mdx
✅ fr: content/docs/fr/{category}/{slug}.mdx
📂 Navigation (meta.json):
✅ en: content/docs/en/{category}/meta.json ("{English Category Name}")
✅ zh: content/docs/zh/{category}/meta.json ("{Chinese Category Name}")
✅ fr: content/docs/fr/{category}/meta.json ("{French Category Name}")
📌 Article added to sidebar navigation
🎨 Icon: {category_icon}
🎨 Article Cover (Step 4.5):
✅ Generated SVG illustration using philosophical-illustrator
📁 Saved to: public/images/docs/{slug}/cover.svg
🎨 Color palette: {palette_name} ({domain} domain)
📏 Dimensions: 800x450px
🔗 Referenced in frontmatter: image: /images/docs/{slug}/cover.svg
✨ Visual theme: {theme_description}
🌐 Shared across all language versions (language-agnostic)
(Or: ⚠️ Cover generation skipped/failed - article continues without image)
🌐 Multi-Language Processing:
✅ Technical terms preserved: Claude, Skills, MCP, Agent, API, SDK
✅ Code blocks unchanged across all languages
✅ Frontmatter properly localized
✅ All language versions validated
🎉 Next Steps:
1. Review generated MDX files for accuracy
2. Test article in local Fumadocs (npm run dev)
3. Verify all language versions render correctly
4. Check navigation in all languages
5. Run build to ensure no errors (npm run build)
Article Structure Template
Generated articles follow this proven structure:
1. Introduction (what is this skill?)
2. Skill Anatomy (directory structure)
3. Bundled Resources (scripts, references, assets)
4. Technical Deep Dive (how it works)
5. Usage Examples (practical demonstrations)
6. Best Practices (design principles)
7. Integration Patterns (with other skills)
8. Real-World Use Cases
9. Troubleshooting Guide
10. Conclusion and Next Steps
Component Usage Guide
Recommended Fumadocs components:
<Callout type="info|warn|tip|error">: Highlight important points
<Cards> + <Card>: Group related concepts
<Steps> + <Step>: Show procedural workflows
<Files> + <Folder> + <File>: Display directory structures
<Tabs> + <Tab>: Show alternative approaches
Writing pattern example:
<Callout type="info">
This is a production-ready skill from the Anthropic repository.
</Callout>
<CodeBlock title="Example Usage">
```bash
python script.py --help
Examples
Example 1: Analyzing skill-creator
Source: github.com/anthropics/skills/tree/main/skill-creator
Analysis output:
{
"name": "skill-creator",
"complexity": "moderate",
"resource_types": ["scripts"],
"key_features": [
"6-step creation process",
"Progressive disclosure pattern",
"Validation and packaging"
]
}
Generated article: See examples/skill-creator-output.md
Example 2: Analyzing mcp-builder
Source: github.com/anthropics/skills/tree/main/mcp-builder
Analysis output:
{
"name": "mcp-builder",
"complexity": "complex",
"resource_types": ["scripts", "references"],
"key_features": [
"MCP specification analysis",
"Server implementation guidance",
"Tool definition workflows"
]
}
Best Practices
When to Use This Skill
✅ DO use skill-article-writer when:
- You need to document an existing skill
- Creating tutorials for internal skill development
- Analyzing best practices from example skills
- Generating educational content for the Claude community
- Creating multi-language documentation
❌ DON'T use skill-article-writer when:
- Writing about non-skill topics (use direct writing instead)
- Creating quick notes or brief summaries
- Documenting one-off workflows
- The source skill is not from Anthropic skills repository
Article Quality Standards
Each generated article should:
- Be comprehensive: Cover all aspects of the skill (2000-4000 words)
- Include practical examples: Show real usage with code snippets
- Follow proven structure: Use the template sections consistently
- Be accessible: Provide context for readers unfamiliar with the domain
- Be actionable: Include clear next steps and related resources
Multi-Language Quality Standards
Translation Quality:
- Preserve English terms (see Terms to Preserve list in Step 5)
- Claude, Skills, Projects, MCP, Agent, SubAgent
- GitHub, Google Drive, Slack, Excel
- React, Python, Node.js, TypeScript
- API, SDK, AI, ML, RAG, UI, UX
- All variable/function/class names in code
- Technical accuracy is paramount
- Preserve code examples exactly (including identifiers)
- Adapt cultural references when necessary
- Use appropriate technical terminology for each language
- Chinese (zh): 使用简体中文,技术术语保持英文
- Example: "Claude 的 Skills 功能" (NOT: "克劳德的技能功能")
- Example: "使用 React 组件" (NOT: "使用回应组件")
- French (fr): Maintain formal tone, keep English terms as-is
- Example: "La fonctionnalité Skills de Claude" (NOT translated)
- Example: "Utilisez le composant React" (NOT: "Réagir")
File Organization:
Follow Fumadocs conventions:
- Language-specific directories:
content/docs/{lang}/ (en, zh, fr)
- Category subdirectories:
content/docs/{lang}/{category}/
- meta.json files: Localized category titles for each language
- Navigation: Consistent structure across all languages
Writing Style Guidelines
Critical: Always use imperative/infinitive form
❌ Wrong: "You should run the analysis script"
✅ Right: "Run the analysis script to extract metadata"
❌ Wrong: "If you want to create an article..."
✅ Right: "To create a comprehensive article..."
Maintain consistency:
- Verb-first sentences in all instructions
- Clear section headings
- Logical flow from overview to details
- Balanced use of components (not too many, not too few)
Integration with Other Skills
skill-article-writer works well with:
- skill-creator: Document new skills you create
- skill-builder: Analyze complex skill architectures
- translator: Generate multi-language versions
- fumadocs-article-importer: Import external skill documentation
Troubleshooting
Analysis Script Errors
Symptom: analyze_skill.py reports parsing errors
Causes:
- SKILL.md has invalid YAML frontmatter
- File encoding issues
- Missing files or directories
Solutions:
- Verify SKILL.md starts with
--- and has valid YAML
- Check file encoding is UTF-8
- Ensure skill directory structure is complete
Missing Components
Symptom: Generated articles don't include expected Fumadocs components
Cause: Outline generator creates component placeholders, but they need to be manually expanded
Solution: Review the outline and expand component sections with actual content:
- Replace
<Callout> placeholders with real callouts
- Add examples to
<Steps> sections
- Fill in
<Cards> with relevant information
Translation Issues
Symptom: Technical terms like "Skills" or "Agent" are translated
Cause: Not following "Terms to Preserve" guidelines
Solutions:
Maintain the list of English terms that should not be translated:
- Claude, Skills, SKILL.md, Agent, SubAgent, MCP
- GitHub, Google Drive, Slack, Excel
- React, Python, Node.js, TypeScript
- API, SDK, AI, ML, RAG, UI, UX
Check each translation for accidentally translated terms
Conclusion
skill-article-writer provides a systematic way to:
- ✅ Analyze skill structure and extract insights
- ✅ Generate comprehensive tutorial articles
- ✅ Create multi-language documentation efficiently
- ✅ Follow proven patterns for skill explanations
- ✅ Scale documentation creation across many skills
By using this skill, you can create high-quality educational content that helps others understand and use Claude skills effectively.
Appendix
Related Resources
- Anthropic Skills Repository: github.com/anthropics/skills
- Claude Code Documentation: claude.ai/docs
- Fumadocs Documentation: fumadocs.com
- Example Skill Articles: See
examples/ directory
Article Templates
For different skill types, see:
references/article-templates.md - Template variations
examples/skill-creator-output.md - Full example analysis
references/writing-style-guide.md - Writing conventions
ℹ️ Source Information
Base Skill Analysis: skill-creator
- Source: Anthropic Skills Repository
- Author: Anthropic
- License: See LICENSE.txt
This skill was created by analyzing best practices from skill-creator and applying them to the domain of skill documentation.
1---2name: skill-article-writer3description: Generate comprehensive analysis articles from Claude skills. This skill should be used when you want to analyze a skill from the Anthropic skills repository and create a detailed tutorial article explaining its structure, design patterns, and usage. Perfect for creating documentation, tutorials, and educational content about existing skills.4license: Complete terms in LICENSE.txt5---67# skill-article-writer89Generate comprehensive analysis articles from Claude skills. This skill transforms any skill from the Anthropic repository into a detailed tutorial with explanations, best practices, and usage examples.1011## What This Skill Does1213**skill-article-writer** is a meta-skill that:14- Analyzes skill structure and bundled resources15- Generates detailed article outlines16- Creates comprehensive tutorials with code examples17- Produces multi-language versions (en, zh, fr)18- Follows proven documentation patterns1920**Use cases**:21- Creating documentation for internal skills22- Writing tutorials for skill development23- Analyzing best practices from example skills24- Generating educational content for Claude users2526### Skills vs. Articles2728- **Skills**: Executable workflows that extend Claude's capabilities29- **Articles**: Educational content that explains how skills work30- **This Skill**: Bridges the gap by analyzing skills and creating articles3132## Prerequisites3334Before using this skill, you must have:35361. **Access to Anthropic skills repository**: `github.com/anthropics/skills`372. **Local clone of target skill**: The skill must be available locally383. **Python 3.x**: Required for analysis scripts394. **Write access**: Ability to create article files in your project4041## How The Skill Works4243### Progressive Analysis4445This skill uses a three-stage analysis process:46471. **Structure Analysis** (`analyze_skill.py`)48 - Examines directory structure49 - Parses SKILL.md metadata50 - Identifies bundled resources51 - Generates comprehensive metadata52532. **Outline Generation** (`generate_article_outline.py`)54 - Creates article structure55 - Plans section content56 - Identifies code examples57 - Generates markdown template58593. **Content Creation**60 - Fills in outline with detailed analysis61 - Adds practical examples62 - Creates multi-language versions63 - Validates MDX syntax6465### Output Structure6667Each generated article follows this structure:6869```701. Introduction (what is this skill?)712. Skill Anatomy (directory structure)723. Technical Deep Dive (how it works)734. Usage Examples (practical demonstrations)745. Best Practices (design principles)756. Integration Patterns (with other skills)767. Troubleshooting (common issues)778. Conclusion and Next Steps78```7980## Directory Structure8182The skill-article-writer includes helper scripts for automation:8384```85skill-article-writer/86├── SKILL.md # This file87├── scripts/88│ ├── analyze_skill.py # Analyze skill structure89│ └── generate_article_outline.py # Generate article template90├── references/91│ └── article-templates.md # Template patterns for different skill types92└── examples/93 └── skill-creator-output.md # Example: analysis of skill-creator94```9596## The 7-Step Article Creation Process9798### Step 1: Understand the Source Skill99100**Purpose**: Gain deep understanding of the skill's structure and purpose101102**Actions**:1031. **Read the skill's SKILL.md**: Understand what problem it solves1042. **Examine bundled resources**: Scripts, references, and assets1053. **Identify key workflows**: How does the skill accomplish its goals?1064. **Note the target audience**: Who is this skill designed for?107108**Output**: Comprehensive understanding of the skill's value proposition109110**Example**: When analyzing `skill-creator`, we identified:111- **Problem solved**: Manual skill creation is error-prone112- **Key workflows**: 6-step creation process with validation113- **Target audience**: Developers creating Claude skills114- **Value proposition**: Systematic approach ensures quality and consistency115116### Step 2: Analyze Structure and Extract Metadata117118**Purpose**: Extract structured information for article generation119120**Run analysis script**:121```bash122scripts/analyze_skill.py /path/to/skill-name > /tmp/skill-metadata.json123```124125**What the script extracts**:126- Directory structure and file organization127- YAML frontmatter (name, description, etc.)128- Section headings and content structure129- Bundled resources inventory130- Commands and usage patterns131- Workflow steps132133**Output**: JSON metadata file with structured skill information134135**Key insight**: This metadata serves as the single source of truth for article generation136137### Step 3: Generate Article Outline138139**Purpose**: Create a structured outline that covers all important aspects140141**Run outline generator**:142```bash143scripts/generate_article_outline.py /tmp/skill-metadata.json > /tmp/article-outline.md144```145146**The outline includes**:147- Complete article structure with all sections148- Calls to action for expansion149- Component placeholders (Callouts, Cards, Steps)150- Source attribution blocks151- Appendix for detailed resource listings152153**Design considerations**:154- Follows proven article structure from successful skill analyses155- Adapts section depth based on skill complexity156- Includes both overview and deep-dive sections157- Provides practical examples and use cases158159**Output**: Comprehensive outline (150-200 lines) covering:160- Introduction and overview161- Technical deep dive162- Usage examples163- Best practices164- Troubleshooting165- Conclusion166167### Step 4: Research and Expand Content168169**Purpose**: Transform the outline into a detailed, informative article170171**Content expansion process**:1721731. **Fill in section details**:174 - Explain each concept thoroughly175 - Add code snippets and examples176 - Include practical demonstrations177 - Provide real-world use cases1781792. **Add visual elements**:180 - Insert `<Callout type="info|warn|tip">` for important points181 - Use `<Cards>` and `<Card>` for related concepts182 - Add `<Steps>` and `<Step>` for procedural content183 - Include `<Files>`, `<Folder>`, `<File>` for directory structures1841853. **Create practical examples**:186 - Walk through a complete example187 - Show before and after188 - Include expected output189 - Highlight key takeaways1901914. **Add cross-references**:192 - Link to related skills193 - Reference external documentation194 - Connect to broader concepts195196**Writing style**: Use imperative/infinitive form throughout197198- ❌ **Wrong**: "You should run the script"199- ✅ **Right**: "Run the script"200201**Output**: Complete article draft in English (3000-4000 words)202203### Step 4.5: Generate Article Cover Illustration204205**Purpose**: Automatically create a modern, theme-relevant SVG cover illustration for the skill analysis article.206207**Why this matters**:208- Visual appeal increases engagement and readability209- Consistent illustration style across all skill documentation210- Saves time compared to manual design211- Automatically matches skill theme and technical domain212213**Process**:2142151. **Invoke the philosophical-illustrator skill**:216 - This skill generates modern, colorful SVG illustrations for technical content217 - Automatically selects color palette based on skill domain218 - Creates theme-relevant visual metaphors2192202. **Prepare illustration context from skill analysis**:221 ```222 Skill Name: {skill-name}223 Article Title: {article-title}224 Main Topic: {skill's main purpose}225 Key Concepts: {extracted from Step 1 and Step 3}226 Technical Domain: {development/data/ai-ml/testing/etc.}227 ```2282293. **Domain-to-Category Mapping** (for color palette selection):230231 | Skill Domain | Category | Palette | Colors |232 |--------------|----------|---------|--------|233 | Code/Development | development | Pink-Purple | #C67B9B, #B8789E, #A97BA1 |234 | AI/ML/Agents | ai-ml | Pink-Purple | #C67B9B, #B8789E, #A97BA1 |235 | Data Processing | data | Beige-Neutral | #C9BFA8, #D4CAAF, #B8AD98 |236 | Testing/QA | development | Blue | #5B8FB9, #6B9BC4, #7AA5C8 |237 | DevOps/Infrastructure | devops | Green-Olive | #6B7F64, #758C6E, #607360 |238 | Security | security | Blue | #5B8FB9, #6B9BC4, #7AA5C8 |239 | Design/UI | design | Orange-Coral | #D17B5C, #C88860, #B87A5D |240 | General/Multi-purpose | content | Multi-topic | #CA8760, #D17B5C, #B87A5D |2412424. **Generate SVG illustration**:243 - Use the Skill tool to invoke philosophical-illustrator244 - Pass skill name, domain, and key concepts245 - The skill will generate a 800x450px SVG with theme-relevant imagery246 - For skill analysis articles, focus on visual metaphors that represent:247 - Workflow automation (gears, connections, flow diagrams)248 - Code structure (brackets, files, hierarchies)249 - Problem-solving (lightbulbs, tools, transformations)2502515. **Save illustration**:252 ```bash253 mkdir -p "public/images/docs/{article-slug}"254 # Save SVG output to:255 # public/images/docs/{article-slug}/cover.svg256 ```2572586. **Update frontmatter reference**:259 - Add to frontmatter: `image: /images/docs/{article-slug}/cover.svg`260 - This field will be used by Fumadocs for article preview cards261 - Image appears in:262 - Article header263 - Card previews in navigation264 - Social media sharing (og:image)265266**Example invocation**:267```268Use the philosophical-illustrator skill to generate a cover illustration:269270Skill: skill-creator271Article Title: "Skill Creator Deep Dive: Systematic Approach to Building Claude Skills"272Domain: development273Key Concepts: Progressive disclosure, validation, bundled resources, 6-step process274Description: Analysis of skill-creator, a meta-skill for creating high-quality Claude skills275276Please create a modern SVG illustration with:277- Pink-Purple color palette (development domain)278- Visual elements: code brackets, file structure icons, workflow connections, gears279- Metaphors: building blocks, systematic process, quality validation280- Modern, friendly aesthetic281- 800x450px dimensions282```283284**Output**:285- SVG file saved to `public/images/docs/{slug}/cover.svg`286- Frontmatter updated with `image` field287- Illustration ready for all language versions (reused across en, zh, fr)288289**Fallback**:290- If illustration generation fails, continue without image291- Log warning in summary report292- Article still functions normally (image is optional)293294**Note**: The same cover image is used for all language versions of the article, as visual metaphors are language-agnostic.295296### Step 5: Create Multi-Language Versions297298**Purpose**: Make the article accessible to international audiences299300#### CRITICAL: Terms to Preserve (DO NOT TRANSLATE)301302Certain terms must remain in English as they are:303- **Product/Brand Names**: Claude, Anthropic, Claude.ai, Claude Code304- **Technical Concepts/Features**: Skills, Projects, MCP, Agent, SubAgent305- **Specific Tools**: GitHub, Google Drive, Slack, Excel306- **Framework/Technology Names**: React, Python, Node.js, TypeScript307- **Standard Acronyms**: API, SDK, AI, ML, RAG, UI, UX308- **Code Examples**: Variable names, function names, class names309310**Translation Instruction**:311```312Translate the following to {language_name}, but PRESERVE these terms in English:313- Claude, Anthropic, Skills, Projects, MCP, Agent, SubAgent314- GitHub, Google Drive, Slack, Excel315- React, Python, Node.js, TypeScript316- API, SDK, AI, ML, RAG, UI, UX317- All code identifiers (variable/function/class names)318319Why: These are proper names, brand names, or universal technical terms.320Translating them would confuse readers who expect the standard English terms.321322Example of CORRECT translation:323English: "Claude's Skills feature helps agents work better"324Chinese: "Claude 的 Skills 功能帮助 agents 更好地工作" (NOT: "克劳德的技能功能帮助代理更好地工作")325326Example of CORRECT translation:327English: "Use the React component with Node.js"328French: "Utilisez le composant React avec Node.js" (NOT: "Utilisez le composant Réagir avec Noeud.js")329```330331#### Translation Process332333For each target language (en, zh, fr):3343351. **Prepare content for translation**:336 - Combine title, description, and main content337 - Ensure code blocks are clearly marked338 - Keep image references intact339 - Mark terms to preserve (see list above)3403412. **Request translation**:342 - Ask for professional translation to the target language343 - Specify that this is technical documentation344 - Emphasize the need to preserve Markdown formatting and code blocks345 - **CRITICAL**: List all terms that must NOT be translated (from the preserve list above)346347 Example request format:348 ```349 Please translate the following article to Chinese (zh).350 This is technical documentation - preserve all Markdown syntax, code blocks,351 and image references exactly as they appear.352353 CRITICAL: DO NOT translate these terms - keep them in English:354 - Claude, Anthropic, Skills, Projects, MCP, Agent, SubAgent, Subagents355 - GitHub, Google Drive, Slack, Excel356 - React, Python, Node.js, TypeScript, JavaScript357 - API, SDK, AI, ML, RAG, UI, UX, REST, HTTP358 - All variable names, function names, and class names in code blocks359360 Why preserve: These are proper names, brand names, or universal technical terms.361 Translating them would confuse readers.362363 Example correct translation:364 WRONG: "克劳德的技能功能帮助代理更好地工作"365 CORRECT: "Claude 的 Skills 功能帮助 agents 更好地工作"366367 Article to translate:368 [Article content here]369 ```3703713. **Translation will automatically apply**:372 - Professional translation quality (via translator skill)373 - **Preserves specified English terms in all languages**374 - Preservation of all Markdown syntax375 - Code blocks remain unchanged (including identifiers)376 - Image references stay the same (paths unchanged)377 - Heading hierarchy maintained378 - Technical terms handled appropriately for target language379 - Natural, fluent target language text3803814. **Language-specific handling**:382 - **Chinese (zh)**: Simplified Chinese, technical terms stay in English when appropriate383 - Format: English term with normal text (e.g., "Skills 功能" not "技能功能")384 - No extra spaces needed around English terms385 - **French (fr)**: Standard French technical terminology, formal tone386 - English terms remain in original form387 - **English (en)**: Clear, professional US English3883895. **Quality considerations**:390 - Translation preserves the original meaning and intent391 - Technical accuracy is maintained392 - Content reads naturally in the target language393 - Format and structure remain identical to source3943956. **Save translations**:396 - Save original English version first397 - Then save each translated version398 - Maintain consistent file structure across all languages399400**Output**: Three complete article versions (en, zh, fr)401402### Step 6: Create/Update meta.json for All Languages403404**Purpose**: Ensure proper sidebar navigation with localized titles for all languages405406**CRITICAL**: Create proper meta.json files for sidebar navigation with localized titles.407408Load reference files:409- `references/category-translations.json` - Get translated category names410- `references/category-icons.json` - Get appropriate icons411412For **each language** (en, zh, fr):4134141. **Create/Update category meta.json**: `content/docs/{lang}/{category}/meta.json`415416 ```json417 {418 "title": "{translated_category_name}",419 "icon": "{category_icon}",420 "pages": ["{article-slug}", "..."],421 "defaultOpen": false422 }423 ```424425 **Example for ai-ml category:**426 - **English** (`content/docs/en/ai-ml/meta.json`):427 ```json428 {429 "title": "AI & Machine Learning",430 "icon": "Brain",431 "pages": ["{article-slug}", "..."],432 "defaultOpen": false433 }434 ```435436 - **Chinese** (`content/docs/zh/ai-ml/meta.json`):437 ```json438 {439 "title": "AI 与机器学习",440 "icon": "Brain",441 "pages": ["{article-slug}", "..."],442 "defaultOpen": false443 }444 ```445446 - **French** (`content/docs/fr/ai-ml/meta.json`):447 ```json448 {449 "title": "IA et Apprentissage Automatique",450 "icon": "Brain",451 "pages": ["{article-slug}", "..."],452 "defaultOpen": false453 }454 ```4554562. **Handling existing meta.json:**457 - If file exists, read current `pages` array458 - Ask user: "Where to add new article? (1: top, 2: bottom, 3: alphabetical)"459 - Preserve other user customizations (icon, defaultOpen, etc.)460 - If `pages` array exists, insert article slug; if not, create with `["{slug}", "..."]`4614623. **Update/Create root meta.json**: `content/docs/{lang}/meta.json`463464 - Check if category is listed in root `pages` array465 - If not, ask user: "Add '{category}' to root navigation? (yes/no)"466 - If yes, ask: "Where to add? (1: top, 2: bottom, 3: after specific item)"467468 **Example root meta.json:**469 ```json470 {471 "title": "Documentation",472 "pages": [473 "index",474 "getting-started",475 "---[Book]Categories---",476 "ai-ml",477 "development",478 "data",479 "..."480 ]481 }482 ```4834844. **Translation mapping for all 8 categories:**485486 | Category | English | Chinese | French |487 |----------|---------|---------|--------|488 | ai-ml | AI & Machine Learning | AI 与机器学习 | IA et Apprentissage Automatique |489 | development | Development | 开发 | Développement |490 | data | Data | 数据 | Données |491 | design | Design | 设计 | Design |492 | content | Content | 内容 | Contenu |493 | business | Business | 商业 | Affaires |494 | devops | DevOps | DevOps | DevOps |495 | security | Security | 安全 | Sécurité |4964975. **Icon mapping for categories:**498499 | Category | Icon | Alternative Icons |500 |----------|------|-------------------|501 | ai-ml | Brain | Cpu, Zap, Sparkles |502 | development | Code | Terminal, Braces, FileCode |503 | data | Database | BarChart, PieChart, TrendingUp |504 | design | Palette | Paintbrush, Layers, Layout |505 | content | FileText | BookOpen, Book, FileEdit |506 | business | Briefcase | TrendingUp, DollarSign, Users |507 | devops | Server | Cloud, Container, GitBranch |508 | security | Shield | Lock, ShieldCheck, Key |509510**Important Notes:**511- Always create meta.json for ALL 3 languages (en, zh, fr), not just English512- Use localized titles from the translation mapping513- Use the `...` syntax to auto-include other pages: `["featured-article", "..."]`514- Never hardcode English titles in non-English meta.json files515- Preserve user's existing customizations when updating516517**Output**: meta.json files created/updated for all languages with proper navigation structure518519### Step 7: Package and Validate520521**Purpose**: Ensure articles are ready for publication522523**Validation checklist**:524525✅ **Content validation**:526- [ ] MDX syntax is correct527- [ ] All components are properly imported528- [ ] Frontmatter is valid YAML529- [ ] SourceAttribution component is present530- [ ] Links are working531- [ ] Code blocks are syntax-highlighted532533✅ **Build validation**:534- [ ] `npm run build` completes without errors535- [ ] All language versions render correctly536- [ ] No missing imports or undefined components537- [ ] Responsive design works (mobile, tablet, desktop)538539✅ **Quality checks**:540- [ ] Article is comprehensive (2000+ words)541- [ ] Examples are practical and clear542- [ ] Best practices are highlighted543- [ ] Related articles are cross-referenced544- [ ] Summary provides actionable next steps545546✅ **Multi-language verification**:547- [ ] All 3 language versions created (en, zh, fr)548- [ ] Technical terms preserved in all languages (Claude, Skills, MCP, etc.)549- [ ] meta.json files created/updated for all languages550- [ ] Category titles properly localized551- [ ] Navigation structure consistent across languages552553**Output**: Production-ready articles in three languages554555**Expected file structure**:556```557content/docs/558├── en/{category}/559│ ├── meta.json (English category title)560│ └── {article-slug}.mdx561├── zh/{category}/562│ ├── meta.json (Chinese category title)563│ └── {article-slug}.mdx564└── fr/{category}/565 ├── meta.json (French category title)566 └── {article-slug}.mdx567```568569**Summary report template**:570```571✅ Article Creation Complete!572573📄 Article: {title}574🔗 Source Skill: {skill-name}575📁 Category: {category}576🏷️ Tags: {tag1, tag2, tag3, ...}577578📝 Files Created:579 ✅ en: content/docs/en/{category}/{slug}.mdx580 ✅ zh: content/docs/zh/{category}/{slug}.mdx581 ✅ fr: content/docs/fr/{category}/{slug}.mdx582583📂 Navigation (meta.json):584 ✅ en: content/docs/en/{category}/meta.json ("{English Category Name}")585 ✅ zh: content/docs/zh/{category}/meta.json ("{Chinese Category Name}")586 ✅ fr: content/docs/fr/{category}/meta.json ("{French Category Name}")587 📌 Article added to sidebar navigation588 🎨 Icon: {category_icon}589590🎨 Article Cover (Step 4.5):591 ✅ Generated SVG illustration using philosophical-illustrator592 📁 Saved to: public/images/docs/{slug}/cover.svg593 🎨 Color palette: {palette_name} ({domain} domain)594 📏 Dimensions: 800x450px595 🔗 Referenced in frontmatter: image: /images/docs/{slug}/cover.svg596 ✨ Visual theme: {theme_description}597 🌐 Shared across all language versions (language-agnostic)598 (Or: ⚠️ Cover generation skipped/failed - article continues without image)599600🌐 Multi-Language Processing:601 ✅ Technical terms preserved: Claude, Skills, MCP, Agent, API, SDK602 ✅ Code blocks unchanged across all languages603 ✅ Frontmatter properly localized604 ✅ All language versions validated605606🎉 Next Steps:607 1. Review generated MDX files for accuracy608 2. Test article in local Fumadocs (npm run dev)609 3. Verify all language versions render correctly610 4. Check navigation in all languages611 5. Run build to ensure no errors (npm run build)612```613614## Article Structure Template615616Generated articles follow this proven structure:617618```6191. Introduction (what is this skill?)6202. Skill Anatomy (directory structure)6213. Bundled Resources (scripts, references, assets)6224. Technical Deep Dive (how it works)6235. Usage Examples (practical demonstrations)6246. Best Practices (design principles)6257. Integration Patterns (with other skills)6268. Real-World Use Cases6279. Troubleshooting Guide62810. Conclusion and Next Steps629```630631### Component Usage Guide632633**Recommended Fumadocs components**:634635- **`<Callout type="info|warn|tip|error">`**: Highlight important points636- **`<Cards>` + `<Card>`**: Group related concepts637- **`<Steps>` + `<Step>`**: Show procedural workflows638- **`<Files>` + `<Folder>` + `<File>`**: Display directory structures639- **`<Tabs>` + `<Tab>`**: Show alternative approaches640641**Writing pattern example**:642643```mdx644<Callout type="info">645 This is a production-ready skill from the Anthropic repository.646</Callout>647648<CodeBlock title="Example Usage">649```bash650python script.py --help651```652</CodeBlock>653654<Steps>655 <Step>656 **Step 1**: Do this first...657 </Step>658 <Step>659 **Step 2**: Then do this...660 </Step>661</Steps>662```663664## Examples665666### Example 1: Analyzing skill-creator667668**Source**: `github.com/anthropics/skills/tree/main/skill-creator`669670**Analysis output**:671```json672{673 "name": "skill-creator",674 "complexity": "moderate",675 "resource_types": ["scripts"],676 "key_features": [677 "6-step creation process",678 "Progressive disclosure pattern",679 "Validation and packaging"680 ]681}682```683684**Generated article**: See `examples/skill-creator-output.md`685686### Example 2: Analyzing mcp-builder687688**Source**: `github.com/anthropics/skills/tree/main/mcp-builder`689690**Analysis output**:691```json692{693 "name": "mcp-builder",694 "complexity": "complex",695 "resource_types": ["scripts", "references"],696 "key_features": [697 "MCP specification analysis",698 "Server implementation guidance",699 "Tool definition workflows"700 ]701}702```703704## Best Practices705706### When to Use This Skill707708✅ **DO use skill-article-writer when**:709- You need to document an existing skill710- Creating tutorials for internal skill development711- Analyzing best practices from example skills712- Generating educational content for the Claude community713- Creating multi-language documentation714715❌ **DON'T use skill-article-writer when**:716- Writing about non-skill topics (use direct writing instead)717- Creating quick notes or brief summaries718- Documenting one-off workflows719- The source skill is not from Anthropic skills repository720721### Article Quality Standards722723Each generated article should:7247251. **Be comprehensive**: Cover all aspects of the skill (2000-4000 words)7262. **Include practical examples**: Show real usage with code snippets7273. **Follow proven structure**: Use the template sections consistently7284. **Be accessible**: Provide context for readers unfamiliar with the domain7295. **Be actionable**: Include clear next steps and related resources730731### Multi-Language Quality Standards732733**Translation Quality**:734- **Preserve English terms** (see Terms to Preserve list in Step 5)735 - Claude, Skills, Projects, MCP, Agent, SubAgent736 - GitHub, Google Drive, Slack, Excel737 - React, Python, Node.js, TypeScript738 - API, SDK, AI, ML, RAG, UI, UX739 - All variable/function/class names in code740- Technical accuracy is paramount741- Preserve code examples exactly (including identifiers)742- Adapt cultural references when necessary743- Use appropriate technical terminology for each language744- **Chinese (zh)**: 使用简体中文,技术术语保持英文745 - Example: "Claude 的 Skills 功能" (NOT: "克劳德的技能功能")746 - Example: "使用 React 组件" (NOT: "使用回应组件")747- **French (fr)**: Maintain formal tone, keep English terms as-is748 - Example: "La fonctionnalité Skills de Claude" (NOT translated)749 - Example: "Utilisez le composant React" (NOT: "Réagir")750751**File Organization**:752Follow Fumadocs conventions:753- Language-specific directories: `content/docs/{lang}/` (en, zh, fr)754- Category subdirectories: `content/docs/{lang}/{category}/`755- meta.json files: Localized category titles for each language756- Navigation: Consistent structure across all languages757758### Writing Style Guidelines759760**Critical: Always use imperative/infinitive form**761762❌ **Wrong**: "You should run the analysis script"763✅ **Right**: "Run the analysis script to extract metadata"764765❌ **Wrong**: "If you want to create an article..."766✅ **Right**: "To create a comprehensive article..."767768**Maintain consistency**:769- Verb-first sentences in all instructions770- Clear section headings771- Logical flow from overview to details772- Balanced use of components (not too many, not too few)773774## Integration with Other Skills775776skill-article-writer works well with:7777781. **skill-creator**: Document new skills you create7792. **skill-builder**: Analyze complex skill architectures7803. **translator**: Generate multi-language versions7814. **fumadocs-article-importer**: Import external skill documentation782783## Troubleshooting784785### Analysis Script Errors786787**Symptom**: `analyze_skill.py` reports parsing errors788789**Causes**:790- SKILL.md has invalid YAML frontmatter791- File encoding issues792- Missing files or directories793794**Solutions**:7951. Verify SKILL.md starts with `---` and has valid YAML7962. Check file encoding is UTF-87973. Ensure skill directory structure is complete798799### Missing Components800801**Symptom**: Generated articles don't include expected Fumadocs components802803**Cause**: Outline generator creates component placeholders, but they need to be manually expanded804805**Solution**: Review the outline and expand component sections with actual content:806- Replace `<Callout>` placeholders with real callouts807- Add examples to `<Steps>` sections808- Fill in `<Cards>` with relevant information809810### Translation Issues811812**Symptom**: Technical terms like "Skills" or "Agent" are translated813814**Cause**: Not following "Terms to Preserve" guidelines815816**Solutions**:8171. Maintain the list of English terms that should not be translated:818 - Claude, Skills, SKILL.md, Agent, SubAgent, MCP819 - GitHub, Google Drive, Slack, Excel820 - React, Python, Node.js, TypeScript821 - API, SDK, AI, ML, RAG, UI, UX8228232. Check each translation for accidentally translated terms824825## Conclusion826827**skill-article-writer** provides a systematic way to:828829- ✅ Analyze skill structure and extract insights830- ✅ Generate comprehensive tutorial articles831- ✅ Create multi-language documentation efficiently832- ✅ Follow proven patterns for skill explanations833- ✅ Scale documentation creation across many skills834835By using this skill, you can create high-quality educational content that helps others understand and use Claude skills effectively.836837---838839## Appendix840841### Related Resources842843- **Anthropic Skills Repository**: github.com/anthropics/skills844- **Claude Code Documentation**: claude.ai/docs845- **Fumadocs Documentation**: fumadocs.com846- **Example Skill Articles**: See `examples/` directory847848### Article Templates849850For different skill types, see:851- `references/article-templates.md` - Template variations852- `examples/skill-creator-output.md` - Full example analysis853- `references/writing-style-guide.md` - Writing conventions854855## ℹ️ Source Information856857**Base Skill Analysis**: skill-creator858- **Source**: Anthropic Skills Repository859- **Author**: Anthropic860- **License**: See LICENSE.txt861862*This skill was created by analyzing best practices from skill-creator and applying them to the domain of skill documentation.*