Self-Assessment Skill

Interactive skill assessment tool that evaluates your Claude Code mastery and generates personalized learning paths.

Overview

This skill provides two assessment modes:

• Quick (5 min): 10 questions, one per topic, rapid skill check
• Comprehensive (20 min): 20 questions, two per topic, deep mastery analysis

After assessment, get:

• ✓ Your mastery profile (Beginner/Intermediate/Advanced)
• ✓ Per-topic score breakdown
• ✓ Identified gaps ranked by importance
• ✓ Personalized learning path (respects dependencies)
• ✓ 3 practice projects matched to your level

Usage

Quick Assessment

/self-assessment quick

Fast evaluation across all topics. Shows overall level + top 2-3 gaps.

Comprehensive Assessment

/self-assessment comprehensive

Deep dive into each topic. Shows detailed per-topic scores + full learning path + practice projects.

Options

/self-assessment quick --verbose        # Show detailed explanations
/self-assessment comprehensive --save   # Save results to assessment-results.json

How It Works

Interaction Flow

1. Choose mode: Quick or Comprehensive
2. Answer questions: 4-option multiple choice (A-D)
3. See feedback: Explanation + guide link for each answer
4. Get profile: Mastery assessment across all topics
5. Get learning path: Personalized sequence respecting dependencies
6. Choose action: Learn, practice, retry, or deep-dive on specific topic

Scoring

Quick Mode:

• 10 points total (1 per topic)
• Levels: 0-3 (Beginner), 4-7 (Intermediate), 8-10 (Advanced)

Comprehensive Mode:

• 20 points total (2 per topic)
• Levels: 0-6 (Beginner), 7-13 (Intermediate), 14-20 (Advanced)

Topics Covered

1. Quick Start — Installation and basic workflow
2. Core Concepts — Interaction loop, context, sessions
3. Memory & Settings — CLAUDE.md configuration
4. Agents — Creating and using specialized agents
5. Skills — Building reusable capabilities
6. Commands — Slash commands and automation
7. Hooks — Event-driven triggers and validation
8. MCP Servers — Protocol integration and configuration
9. Advanced Patterns — Multi-agent orchestration, composition
10. Security & Production — Hardening, governance, scaling

Output Examples

Quick Mode Result

╔════════════════════════════════════════╗
║ Quick Assessment Results               ║
╠════════════════════════════════════════╣
║ Score: 7/10                            ║
║ Level: Intermediate Developer          ║
║                                        ║
║ Gaps (improve these):                  ║
║  • Hooks (didn't answer correctly)     ║
║  • MCP Servers (need training)         ║
║  • Advanced Patterns (not covered yet) ║
║                                        ║
║ Next Step:                             ║
║  1. Try /self-assessment comprehensive ║
║  2. Focus on: guide/ultimate-guide.md# ║
║     part-7-hooks                       ║
╚════════════════════════════════════════╝

Comprehensive Mode Result

╔══════════════════════════════════════════════════════╗
║ Comprehensive Mastery Assessment                     ║
╠══════════════════════════════════════════════════════╣
║                                                      ║
║ 01 Quick Start           ██████░░░░  2/2  100%      ║
║ 02 Core Concepts         ████░░░░░░  1/2   50%      ║
║ 03 Memory & Settings     ██████░░░░  2/2  100%      ║
║ 04 Agents                ██░░░░░░░░  1/2   50%      ║
║ 05 Skills                ░░░░░░░░░░  0/2    0%      ║
║ 06 Commands              ████░░░░░░  1/2   50%      ║
║ 07 Hooks                 ░░░░░░░░░░  0/2    0%      ║
║ 08 MCP Servers           ██░░░░░░░░  1/2   50%      ║
║ 09 Advanced Patterns     ░░░░░░░░░░  0/2    0%      ║
║ 10 Security              ██░░░░░░░░  1/2   50%      ║
║                                                      ║
║ OVERALL: Intermediate (11/20 = 55%)                 ║
╚══════════════════════════════════════════════════════╝

Personalized Learning Path Generated (8-12 hours)
- Phase 1: Core Concepts (3 hours) [Required foundation]
- Phase 2: Skills & Hooks (4 hours) [After Phase 1]
- Phase 3: Advanced Patterns (3-4 hours) [After Phase 1 & 2]

3 Practice Projects assigned (see below)

Learning Path

After comprehensive assessment, receive:

Structured Learning Phases

• Phase 1: Fill critical gaps first (respects dependencies)
• Phase 2: Build intermediate skills
• Phase 3: Master advanced patterns and production
• Bonus: Deep-dive on specific weak topics

Each phase includes:

• 📖 Reading assignments (links to specific guide sections)
• 🔨 Hands-on practice (templates from examples/)
• 📝 Knowledge validation (/lesson-quiz [topic])

3 Practice Projects

Get real-world scenarios matched to your level:

1. Project 1: Combine 2-3 topics you're weak in (2-3 hours)
2. Project 2: Real-world workflow (3 hours)
3. Project 3: Production setup or team configuration (3 hours)

Each project includes:

• Clear success criteria
• Step-by-step instructions
• Expected outcomes

Integration with Learning System

This skill works with /lesson-quiz for deeper learning:

# After comprehensive assessment, drill down:
/lesson-quiz 05-skills          # 5 questions on Skills topic
/lesson-quiz 07-hooks           # 5 questions on Hooks topic
/lesson-quiz 09-advanced        # 5 questions on Advanced Patterns

Files in This Skill

• SKILL.md — Main skill definition and documentation
• quick-assessment-prompt.txt — Questions for quick mode (10 questions)
• comprehensive-assessment-prompt.txt — Questions for comprehensive mode (20 questions)
• README.md — This file

Tips for Best Results

1. Answer honestly — Don't guess; skip if unsure (affects learning path quality)
2. Review explanations — Every answer includes why + guide link
3. Retake after learning — Your profile improves with each topic mastered
4. Share results — Use profile to align team training
5. Tailor to your goal — Quick for speed, Comprehensive for depth

Scoring Distribution

Quick Mode (10 questions, 1 per topic)

• Perfect score: 10/10 (100%) — Master level
• Advanced: 8-10/10 (80-100%)
• Intermediate: 4-7/10 (40-70%)
• Beginner: 0-3/10 (0-30%)

Comprehensive Mode (20 questions, 2 per topic)

• Perfect score: 20/20 (100%) — Expert level
• Advanced: 14-20/20 (70-100%)
• Intermediate: 7-13/20 (35-65%)
• Beginner: 0-6/20 (0-30%)

Per-topic mastery:

• 0/2 (0%) — No mastery, focus here first
• 1/2 (50%) — Basic understanding, needs practice
• 2/2 (100%) — Proficient, ready for advanced

Examples

For a New Developer

Quick assessment → Identifies gaps in Core Concepts + Commands
→ Recommended: Read Part 2 + Part 6 of guide
→ Then try Quick assessment again
→ Move to Comprehensive assessment

For an Intermediate Developer

Comprehensive assessment → Shows 50% on MCP + 0% on Hooks
→ Recommended learning path: Hooks Phase (4h) → MCP Phase (3h)
→ Practice Project: Automation workflow combining both
→ Then retry assessment to track improvement

For Team Adoption

All team members take comprehensive assessment
→ Aggregate results show:
  • 80% need Hooks training
  • 50% need Advanced Patterns
  • 20% ready for security hardening
→ Create team learning plan from individual gaps
→ Monthly re-assessments track progress

Future Enhancements

Planned features:

• [ ] Team aggregate reporting (see team gaps at a glance)
• [ ] Progress tracking (compare to previous assessment)
• [ ] Difficulty-adjusted questions (harder if you're scoring high)
• [ ] AI-tuned explanations (explain in your words)
• [ ] Export results (PDF profile, shareable with team leads)