Doc Classifier

doc-classifier Skill

Classify documentation needs based on code changes.

Description

Analyzes git commits, file changes, and feature scope to determine what documentation types are needed. Returns structured classification data.

Inputs

Outputs

{
  "feature": "session tracking",
  "scope": {
    "commands": ["sessions live", "sessions current", "sessions task"],
    "modules": ["src/aiterm/sessions/"],
    "hooks": ["session-register", "session-cleanup"],
    "files_changed": 23,
    "commits": 15
  },
  "classification": {
    "guide": { "score": 8, "needed": true, "reason": "New module with 5 CLI commands" },
    "refcard": { "score": 5, "needed": true, "reason": "5 new commands" },
    "gif_demo": { "score": 6, "needed": true, "reason": "User-facing CLI workflow" },
    "mermaid": { "score": 7, "needed": true, "reason": "Hook-based event system" }
  }
}

Scoring Algorithm

Base Scores

Threshold

• Score >= 3: needed
• Score >= 5: high priority
• Score >= 7: essential

Detection Logic

Command Detection

# Find new @app.command decorators
git diff HEAD~10 --name-only | xargs grep -l "@app.command"

# Parse command names
grep -E "@app\.command\(|def \w+\(" src/*/cli/*.py

Module Detection

# New directories with __init__.py
git diff --diff-filter=A HEAD~10 --name-only | grep "__init__.py"

Hook Detection

# Hook-related files
git diff HEAD~10 --name-only | grep -E "hook|event"

# Hook configuration
grep -E "SessionStart|Stop|PreToolUse" ~/.claude/settings.json

Workflow Detection

# Subcommand groups (Typer)
grep "typer.Typer()" src/*/cli/*.py

# Multi-step docs
grep -E "Step [0-9]" docs/**/*.md

Usage Examples

From /craft:docs:analyze

# Internal call
classification = doc_classifier(
    feature_name="session tracking",
    commit_range="HEAD~15"
)

if classification["guide"]["needed"]:
    # Generate guide
    pass

Standalone

/skill doc-classifier "session tracking" --format json

Integration

Used by:

• /craft:docs:analyze - Main classification command
• /craft:docs:guide - Determine what to generate
• /craft:docs:feature - Smart detection enhancement
• /craft:docs:update - Selective updates

Complements:

• mermaid-linter skill - Validate generated diagrams
• changelog-automation skill - Detect feature boundaries