From content-specialized
Professional editorial review and content improvement for educational materials. Use this skill when users request editorial feedback, content review, writing quality assessment, or improvements to course materials, textbooks, documentation, or any educational content. Invokable with /editor-in-chief or /journalist.
How this skill is triggered — by the user, by Claude, or both
Slash command
/content-specialized:editor-in-chiefThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill provides professional editorial review of educational content, analyzing writing quality, pedagogical effectiveness, structure, and engagement. As an experienced journalist and chief editor, this skill delivers actionable feedback to improve textbook materials, course content, and documentation.
This skill provides professional editorial review of educational content, analyzing writing quality, pedagogical effectiveness, structure, and engagement. As an experienced journalist and chief editor, this skill delivers actionable feedback to improve textbook materials, course content, and documentation.
Start by understanding the content scope:
Sample representative content across different sections:
Evaluate content across these dimensions:
Writing Quality
Tone & Voice
Pedagogical Effectiveness
Structure & Organization
Engagement
Provide structured, actionable recommendations:
Report Format:
# Editorial Review: [Content Name]
## Executive Summary
- Overall assessment (2-3 sentences)
- Key strengths (2-3 bullet points)
- Priority improvements (2-3 bullet points)
## Detailed Analysis
### Writing Quality
[Specific observations with examples]
### Tone & Voice
[Specific observations with examples]
### Pedagogical Effectiveness
[Specific observations with examples]
### Structure & Organization
[Specific observations with examples]
### Engagement
[Specific observations with examples]
## Recommendations
### High Priority (Immediate Impact)
1. [Specific recommendation with rationale]
2. [Specific recommendation with rationale]
### Medium Priority (Significant Improvement)
1. [Specific recommendation with rationale]
2. [Specific recommendation with rationale]
### Low Priority (Polish & Enhancement)
1. [Specific recommendation with rationale]
2. [Specific recommendation with rationale]
## Patterns Observed
- [Cross-cutting pattern 1]
- [Cross-cutting pattern 2]
## Exemplary Sections
[Highlight 1-2 sections that demonstrate best practices]
Clarity:
Consistency:
Progressive Complexity:
Good: Overview → Core Concepts → Advanced Topics → Edge Cases
Bad: Advanced Topics → Basic Concepts → Overview
Example Quality:
Good: Real-world scenarios with context and outcomes
Bad: Abstract examples without practical relevance
Knowledge Reinforcement:
Maintain Reader Interest:
Avoid Engagement Killers:
"Problem → Solution → Example"
**Problem**: Context windows limit code analysis to small files.
**Solution**: Use full-repo indexing to semantic search the codebase.
**Example**: Cursor indexes your project, retrieving relevant files with 89% accuracy.
"Concept → Analogy → Application"
**Concept**: Tokens are the building blocks LLMs use.
**Analogy**: Like words in a sentence, but optimized for frequency.
**Application**: "Hello World" = 2 tokens, "API" = 1 token, "GPT-4" = 3 tokens.
"What → Why → How"
**What**: Chain-of-thought prompting reveals reasoning steps.
**Why**: Makes AI decisions transparent and debuggable.
**How**: Prefix prompts with "Let's think step by step:"
"Feature Listing" (lacks context)
❌ Bad:
- Feature A
- Feature B
- Feature C
✓ Good:
- Feature A: Solves X problem by doing Y
- Feature B: Best for Z scenario because...
"Assume Reader Knowledge" (no scaffolding)
❌ Bad: "Use the embeddings API with semantic search."
✓ Good: "Embeddings convert text to numbers representing meaning.
The API creates these embeddings, which you can then search
semantically (by meaning, not keywords)."
When reviewing specific content types:
Introductory Material:
Technical Explanations:
Advanced Topics:
Exercises & Examples:
Comprehensive style guidelines for educational technical content, including:
Reference this file for detailed standards when conducting reviews.
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub amdmax/claude_marketplace --plugin content-specialized