# Checking theme alignment

> Validates that book chapters align with the core theme. Use when user says 'check theme alignment', 'does this fit the theme', 'verify alignment', or automatically after every 2 chapters are drafted.

- Skill: `majiayu000/checking-theme-alignment` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/checking-theme-alignment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/checking-theme-alignment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/checking-theme-alignment

---


# Checking Theme Alignment

Validates chapters against the book's theme to catch drift and maintain coherence.

## When to use this skill

**Automatic triggers:**
- After every 2 chapters are drafted
  - After chapters 2, 4, 6, 8, etc.

**Manual triggers:**
- User says "check theme alignment"
- User says "does chapter X fit the theme?"
- User says "are we still on track?"
- Before making major structural changes

## What this skill does

1. Reads the theme statement from `outline.md`
2. Reads completed chapters
3. Assesses each chapter's alignment
4. Generates alignment report
5. Recommends actions if issues found

## Prerequisites

**Must exist:**
- `outline.md` with theme statement
- At least one completed chapter in `/chapters/`

**If missing:**
```
I need outline.md and at least one chapter to check alignment.
Current status:
- Outline: [exists/missing]
- Chapters: [count]
```

## Alignment assessment scale

**Strong alignment:**
- Chapter clearly advances the theme
- Purpose statement from outline is fulfilled
- Connections to theme are explicit
- Reader can see why this chapter matters

**Adequate alignment:**
- Chapter supports theme but connection could be stronger
- Purpose is fulfilled but not emphasized
- Implicit rather than explicit connection
- Serves the book but feels somewhat tangential

**Weak alignment:**
- Chapter relates to theme but loosely
- Purpose statement not fully delivered
- Connection requires effort to see
- Feels like it could belong in a different book

**Misaligned:**
- Chapter doesn't serve the theme
- Goes in different direction
- Purpose doesn't connect to theme
- Would be better in a different book

## Process

### Step 1: Load theme

Read `outline.md` and extract:
- Theme statement
- Intended audience
- Transformation goal

### Step 2: Assess chapters

For each completed chapter:

1. **Read the chapter content**
2. **Check against theme:**
   - Does opening connect to theme?
   - Do key points advance the theme?
   - Does conclusion tie back to theme?
3. **Check against outline purpose:**
   - Is the stated purpose fulfilled?
   - Are key points from outline delivered?
4. **Rate alignment:** Strong / Adequate / Weak / Misaligned

### Step 3: Generate report

```markdown
=== THEME ALIGNMENT CHECK ===
Date: [current date]
Completed after: Chapter [X]

Theme Statement: [current theme]
Target Audience: [from outline]

## Chapters Assessed

### Chapter 1: [Title]
**Alignment: Strong**
- Opens with clear connection to theme
- All three key points from outline delivered
- Closing reinforces theme effectively

### Chapter 2: [Title]
**Alignment: Adequate**
- Purpose fulfilled but connection to theme is implicit
- Second key point feels tangential
- Consider strengthening theme reference in opening

[Continue for all chapters]

## Overall Assessment

[Summary: all aligned / minor drift / significant issues]

## Recommendations

[Based on findings - see examples below]

## Cross-chapter Flow

[Optional: note how chapters build on each other]
================================
```

### Step 4: Make recommendations

Based on findings:

**All chapters strongly aligned:**
```
All chapters strongly aligned with theme. Continue as planned.
```

**Minor alignment issues:**
```
Recommendation: Strengthen Chapter [X]
- Add explicit theme reference in opening paragraph
- Tie [specific point] back to theme in conclusion
- Otherwise well-aligned
```

**Significant misalignment:**
```
Recommendation: Chapter [X] needs revision
- Current focus: [what it's about]
- Theme: [what it should support]
- Suggested approach: [how to realign]

OR consider whether theme needs adjustment to accommodate this direction.
```

**Theme drift detected:**
```
Pattern detected: Chapters [X, Y, Z] are drifting toward [different focus]

Options:
1. Revise chapters to strengthen theme alignment
2. Adjust theme to: [suggested revised theme]
   - Impact: Would also affect chapters [list]
3. Restructure: Move/remove drifting chapters
```

## Automatic check timing

**After chapter 2:**
- First real assessment (need 2 chapters minimum for patterns)
- Check if both chapters serve theme
- Catch issues early

**After chapter 4:**
- Check chapters 3-4
- Note: Also review 1-2 if issues in 3-4
- Confirm theme holds across first third

**After chapter 6:**
- Check chapters 5-6
- Review overall flow if needed
- Mid-book alignment verification

**Continue every 2 chapters until complete**

## Examples

### Example 1: Strong alignment

```
=== THEME ALIGNMENT CHECK ===
Completed after: Chapter 4

Theme: "Effective delegation requires trust, clarity, and follow-through"

### Chapter 3: Choosing What to Delegate
Alignment: Strong
- Opens by connecting delegation choices to trust-building
- Clarity framework aligns perfectly with theme
- Examples demonstrate all three theme elements

### Chapter 4: The Delegation Conversation
Alignment: Strong
- Explicit theme reference in opening
- Breaks down "clarity" component from theme
- Sets up "follow-through" for next chapter

Overall: All chapters strongly aligned. Continue as planned.
```

### Example 2: Drift detected

```
=== THEME ALIGNMENT CHECK ===
Completed after: Chapter 6

Theme: "Leaders build high-performing teams through psychological safety"

### Chapter 5: Conflict Resolution Techniques
Alignment: Weak
- Focuses on tactics, not psychological safety
- No mention of team performance outcomes
- Could fit in any leadership book

### Chapter 6: Performance Reviews That Work
Alignment: Weak
- Good content but disconnected from safety theme
- Reads like HR process guide
- Missing link to psychological safety

Overall: Significant drift. Chapters 5-6 feel generic rather than 
theme-specific.

Recommendation:
1. Revise Chapter 5: Frame conflict through safety lens
   - "How unsafe conflict damages teams"
   - "Resolution approaches that rebuild safety"
   
2. Revise Chapter 6: Connect reviews to safety
   - "Why traditional reviews destroy safety"
   - "Feedback approaches that strengthen safety"

OR consider broader theme: "Leaders build teams through trust and 
clear systems" (would accommodate these chapters better)
```

### Example 3: Theme adjustment needed

```
=== THEME ALIGNMENT CHECK ===
Completed after: Chapter 8

Theme: "Remote work requires intentional communication practices"

Pattern: Chapters 6-8 increasingly focus on tools and technology, 
not communication practices.

Current chapters:
- Ch 6: Choosing the right tools (tech-focused)
- Ch 7: Setting up your remote workspace (tech-focused)
- Ch 8: Cybersecurity for remote teams (tech-focused)

Original chapters 1-5 were communication-focused, aligned well with theme.

Recommendation: Theme adjustment
- Current: "Remote work requires intentional communication practices"
- Suggested: "Remote work succeeds through thoughtful communication 
  and infrastructure"
- This accommodates both communication AND tools/tech focus
- Would require minor revisions to chapters 1-5 to mention infrastructure

Alternative: Remove/move chapters 6-8 to appendix, stay focused on 
communication practices.
```

## Edge cases

**Only one chapter complete:**
```
I need at least 2 chapters to assess alignment patterns. 
Complete one more chapter and I'll run the check.
```

**Theme statement missing from outline:**
```
I don't see a theme statement in outline.md. 
Every book needs a clear theme to check alignment against.

Should I help you develop a theme based on the chapters written so far?
```

**Chapters exist but outline shows different status:**
```
Note: outline.md shows chapters [X, Y] as "not started" but files exist.
Should I:
1. Assess chapters that exist (regardless of status)
2. Update outline statuses first
```

**User disagrees with assessment:**
Alignment is subjective. If user says "Actually, I think chapter 5 is strongly aligned," accept it:
```
Understood. I'll note chapter 5 as strongly aligned. 
The assessment is to help catch issues, but you know your book best.
```

## Quality standards

Good alignment reports:
- ✓ Reference specific content from chapters
- ✓ Explain WHY alignment is strong/weak
- ✓ Give actionable recommendations
- ✓ Consider whether theme or chapters should change
- ✓ Look at chapter flow, not just individual chapters

Poor alignment reports:
- ✗ Vague: "Chapter seems off"
- ✗ No examples: "Not aligned"
- ✗ No recommendations
- ✗ Only blame chapters (theme might be wrong)
- ✗ Miss patterns across multiple chapters

## Collaboration with other skills

**Before this skill:**
- `draft-chapter` creates chapters to assess
- `revise-chapter` may have changed chapters

**After this skill:**
- `revise-chapter` addresses alignment issues
- `outline-book` may need to revise theme if adjustment recommended
- `draft-chapter` continues with better awareness

## Files read

- `outline.md` - Theme and purposes
- `/chapters/*.md` - All completed chapters

## Files created

None. This skill only generates reports (doesn't modify files).

Report can be:
- Displayed to user
- Optionally saved as `/alignment-reports/report-[date].md` if user wants history

## Best practices

**Do:**
- Be specific about alignment issues
- Suggest concrete fixes
- Consider theme adjustment as valid option
- Look for patterns across chapters
- Remember theme serves the book, not vice versa

**Don't:**
- Just say "aligned" or "not aligned" without explanation
- Assume theme is always right
- Miss the big picture by over-focusing on individual chapters
- Give feedback without actionable recommendations
- Be harsh - alignment issues are normal and fixable