self-assessment

name self-assessment version 2.5.0 description Comprehensive Claude Code self-assessment and learning path advisor. Runs a multi-category quiz covering 10 feature areas, produces a detailed skill profile with per-topic scores, identifies specific gaps, and generates a personalized learning path with prioritized next steps. Use when asked to "assess my level", "take the quiz", "find my level", "where should I start", "what should I learn next", "check my skills", "skill check", or "level up". Self-Assessment & Learning Path Advisor Comprehensive interactive assessment that evaluates Claude Code proficiency across 10 feature areas, identifies specific skill gaps, and generates a personalized learning path to level up. Instructions Step 1: Welcome & Choose Assessment Mode Present the user with a choice of assessment depth: Use AskUserQuestion with these options: Quick Assessment — "8 questions, ~2 minutes. Determines your overall level (Beginner/Intermediate/Advanced) and gives a learning path." Deep Assessment — "5 categories with detailed questions, ~5 minutes. Gives per-topic skill scores, identifies specific gaps, and builds a prioritized learning path." If user chooses Quick Assessment , go to Step 2A. If user chooses Deep Assessment , go to Step 2B. Step 2A: Quick Assessment Present TWO multi-select questions (AskUserQuestion supports max 4 options each): Question 1 (header: "Basics"): "Part 1/2: Which of these Claude Code skills do you already have?" Options: "Start Claude Code and chat" — I can run claude and interact with it "Created/edited CLAUDE.md" — I have set up project or user memory "Used 3+ slash commands" — e.g., /help, /compact, /model, /clear "Created custom command/skill" — Written a SKILL.md or custom command file Question 2 (header: "Advanced"): "Part 2/2: Which of these advanced skills do you have?" Options: "Configured an MCP server" — e.g., GitHub, database, or other external data source "Set up hooks" — Configured hooks in ~/.claude/settings.json "Created/used subagents" — Used .claude/agents/ for task delegation "Used print mode (claude -p)" — Used claude -p for non-interactive or CI/CD use Scoring: 0-2 total = Level 1: Beginner 3-5 total = Level 2: Intermediate 6-8 total = Level 3: Advanced Go to Step 3 with the level result, listing which specific items were NOT checked as gaps. Step 2B: Deep Assessment Present 5 rounds of questions, one AskUserQuestion call per round. Each round covers 2 related feature areas. Use multi-select for all rounds. IMPORTANT : AskUserQuestion supports max 4 options per question. Each round has exactly 1 question with 4 options covering 2 topics (2 options per topic). Round 1 — Slash Commands & Memory (header: "Commands") "Which of these have you done? Select all that apply." Options: "Created a custom slash command or skill" — Written a SKILL.md file with frontmatter, or created .claude/commands/ files "Used dynamic context in commands" — Used $ARGUMENTS , $0 / $1 , backtick !command syntax, or @file references in skill/command files "Set up project + personal memory" — Created both a project CLAUDE.md and personal ~/.claude/CLAUDE.md (or CLAUDE.local.md) "Used memory hierarchy features" — Understand how the 7 memory locations are concatenated into context (loaded root-down, CLAUDE.local.md appended after CLAUDE.md at each level, subdirectory files loaded on demand), used .claude/rules/ directory, path-specific rules, or @import syntax Scoring for Round 1: Options 1-2 map to Slash Commands (0-2 points) Options 3-4 map to Memory (0-2 points) Round 2 — Skills & Hooks (header: "Automation") "Which of these have you done? Select all that apply." Options: "Installed and used an auto-invoked skill" — A skill that triggers automatically based on its description, without manual /command invocation "Controlled skill invocation behavior" — Used disable-model-invocation , user-invocable , or context: fork with agent field in SKILL.md frontmatter "Set up a PreToolUse or PostToolUse hook" — Configured a hook that runs before/after tool execution (e.g., command validator, auto-formatter) "Used advanced hook features" — Configured prompt-type hooks, component-scoped hooks in SKILL.md, HTTP hooks, or hooks with custom JSON output (updatedInput, systemMessage) Scoring for Round 2: Options 1-2 map to Skills (0-2 points) Options 3-4 map to Hooks (0-2 points) Round 3 — MCP & Subagents (header: "Integration") "Which of these have you done? Select all that apply." Options: "Connected an MCP server and used its tools" — e.g., GitHub MCP for PRs/issues, database MCP for queries, or any external data source "Used advanced MCP features" — Project-scope .mcp.json, OAuth authentication, MCP resources with @mentions, Tool Search, or claude mcp serve "Created or configured custom subagents" — Defined agents in .claude/agents/ with custom tools, model, or permissions "Used advanced subagent features" — Worktree isolation, persistent agent memory, background tasks with Ctrl+B, agent allowlists with Agent(agent_type) (the Task(...) form is a back-compat alias), or agent teams Scoring for Round 3: Options 1-2 map to MCP (0-2 points) Options 3-4 map to Subagents (0-2 points) Round 4 — Checkpoints & Advanced Features (header: "Power User") "Which of these have you done? Select all that apply." Options: "Used checkpoints for safe experimentation" — Created checkpoints, used Esc+Esc or /rewind, restored code and/or conversation, or used either Summarize option (summarize from here / summarize up to here) "Used planning mode or extended thinking" — Activated planning via /plan, Shift+Tab, or --permission-mode plan; toggled extended thinking with Alt+T/Option+T "Configured permission modes" — Used any of the six modes — manual (renamed from default in v2.1.200), acceptEdits, plan, auto, dontAsk, or bypassPermissions — via CLI flags, keyboard shortcuts, or settings "Used remote/desktop/web features" — Used claude --remote-control , claude --cloud , /teleport , /desktop , or worktrees with claude -w Scoring for Round 4: Option 1 maps to Checkpoints (0-1 point) Options 2-4 map to Advanced Features (0-3 points) Round 5 — Plugins & CLI (header: "Mastery") "Which of these have you done? Select all that apply." Options: "Installed or created a plugin" — Used a bundled plugin from marketplace, or created a .claude-plugin/ directory with plugin.json manifest "Used plugin advanced features" — Plugin skills ( skills/ — the preferred form; namespaced commands/ is legacy but still works), plugin hooks, plugin MCP servers, LSP configuration, or --plugin-dir flag for testing "Used print mode in scripts or CI/CD" — Used claude -p with --output-format json, --max-turns, piped input, or integrated into GitHub Actions / CI pipelines "Used advanced CLI features" — Session resumption (-c/-r), --agents flag, --json-schema for structured output, --fallback-model, --from-pr, or batch processing loops Scoring for Round 5: Options 1-2 map to Plugins (0-2 points) Options 3-4 map to CLI (0-2 points) Step 3: Calculate & Present Results 3A: For Quick Assessment Count total selections and determine level. Then present: ## Claude Code Skill Assessment Results ### Your Level: [Level 1: Beginner / Level 2: Intermediate / Level 3: Advanced] You checked **N/8** items. [One-line motivational summary based on level] ### Your Skill Profile | Area | Status | |------|--------| | Basic CLI & Conversations | [Checked/Gap] | | CLAUDE.md & Memory | [Checked/Gap] | | Slash Commands (built-in) | [Checked/Gap] | | Custom Commands & Skills | [Checked/Gap] | | MCP Servers | [Checked/Gap] | | Hooks | [Checked/Gap] | | Subagents | [Checked/Gap] | | Print Mode & CI/CD | [Checked/Gap] | ### Identified Gaps [For each unchecked item, provide a 1-line description of what to learn and a link to the tutorial] ### Your Personalized Learning Path [Output the level-specific learning path — see Step 4] 3B: For Deep Assessment Calculate per-topic scores from the 5 rounds. Each topic gets 0-2 points, except Advanced Features (0-3) and Checkpoints (0-1). Then present: ## Claude Code Skill Assessment Results ### Overall Level: [Level 1 / Level 2 / Level 3] **Total Score: N/20 points** [One-line motivational summary] ### Your Skill Profile | Feature Area | Score | Mastery | Status | |-------------|-------|---------|--------| | Slash Commands | N/2 | [None/Basic/Proficient] | [Learn/Review/Mastered] | | Memory | N/2 | [None/Basic/Proficient] | [Learn/Review/Mastered] | | Skills | N/2 | [None/Basic/Proficient] | [Learn/Review/Mastered] | | Hooks | N/2 | [None/Basic/Proficient] | [Learn/Review/Mastered] | | MCP | N/2 | [None/Basic/Proficient] | [Learn/Review/Mastered] | | Subagents | N/2 | [None/Basic/Proficient] | [Learn/Review/Mastered] | | Checkpoints | N/1 | [None/Proficient] | [Learn/Mastered] | | Advanced Features | N/3 | [None/Basic/Proficient] | [Learn/Review/Mastered] | | Plugins | N/2 | [None/Basic/Proficient] | [Learn/Review/Mastered] | | CLI | N/2 | [None/Basic/Proficient] | [Learn/Review/Mastered] | **Mastery key:** 0 = None, 1 = Basic, 2 = Proficient ### Strength Areas [List topics with score 2/2 — these are mastered] ### Priority Gaps (Learn Next) [List topics with score 0 — these need attention first, ordered by dependency] ### Review Areas [List topics with score 1/2 — basics known but advanced features not yet used] ### Your Personalized Learning Path [Output gap-specific learning path — see Step 4] Overall level calculation for Deep Assessment: 0-6 total points = Level 1: Beginner 7-13 total points = Level 2: Intermediate 14-20 total points = Level 3: Advanced Step 4: Generate Personalized Learning Path Based on the assessment results, generate a learning path that is specific to the user's gaps. Do NOT just repeat the generic level path — adapt it. Rules for Path Generation Skip mastered topics : If a topic scored 2/2, do not include it in the path. Prioritize by dependency order : Slash Commands before Skills, Memory before Subagents, etc. The dependency order is: Slash Commands (no deps) -> Skills (depends on Slash Commands) Memory (no deps) -> Subagents (depends on Memory) CLI Basics (no deps) -> CLI Mastery (depends on all) Checkpoints (no deps) Hooks (depends on Slash Commands) MCP (no deps) -> Plugins (depends on MCP, Skills, Hooks) Advanced Features (depends on all previous) For score 1/2 topics : Recommend the "deep dive" — link to the specific advanced section they're missing. Estimate time : Sum only the topics they need to learn/review. Group into phases : Organize remaining topics into logical phases of 2-3 topics each. Path Output Format ### Your Personalized Learning Path **Estimated time** : ~N hours (adjusted for your current skills) #### Phase 1: [Phase Name] (~N hours) [Only if they have gaps in these areas] **[Topic Name]** — [Learn from scratch / Deep dive into advanced features] - Tutorial: [link to tutorial directory] - Focus on: [specific sections/concepts they need] - Key exercise: [one concrete exercise to do] - You'll know it's done when: [specific success criterion] **[Topic Name]** — ... --- #### Phase 2: [Phase Name] (~N hours) ... --- ### Recommended Practice Projects Based on your gaps, try these real-world exercises to solidify your learning: 1. **[Project name]** : [1-line description combining 2-3 gap topics] 2. **[Project name]** : [1-line description] 3. **[Project name]** : [1-line description] Topic-Specific Recommendations Use these specific recommendations when a topic is a gap: Slash Commands (score 0) : Tutorial: 01-slash-commands/ Focus on: Built-in commands reference, creating your first SKILL.md, $ARGUMENTS syntax Key exercise: Create a /optimize command and test it Done when: You can create a custom skill with arguments and dynamic context Slash Commands (score 1 — review) : Focus on: Dynamic context with ! backtick`` syntax, @file references, disable-model-invocation vs user-invocable control Done when: You can create a skill that injects live command output and controls its own invocation behavior Memory (score 0) : Tutorial: 02-memory/ Focus on: CLAUDE.md creation, /init and /memory commands, # prefix for quick updates Key exercise: Create a project CLAUDE.md with your coding standards Done when: Claude remembers your preferences across sessions Memory (score 1 — review) : Focus on: the 7 memory locations and how they are concatenated into context (loaded root-down, not overridden), .claude/rules/ directory with path-specific rules, @import syntax (max depth 4), Auto Memory MEMORY.md (Claude loads its first 200 lines or 25 KB, whichever comes first — a load cap, not a file-size limit) Done when: You have modular rules for different directories and understand how every memory file is concatenated into context Skills (score 0) : Tutorial: 03-skills/ Focus on: SKILL.md format, auto-invocation via description field, progressive disclosure (3 loading levels) Key exercise: Install the code-review skill and verify it auto-triggers Done when: A skill automatically activates based on conversation context Skills (score 1 — review) : Focus on: context: fork with agent field for subagent execution, disable-model-invocation vs user-invocable , the skill-listing budget (1% of the context window, fallback 8,000 characters, 250 characters per entry), bundled resources (scripts/, references/, assets/) Done when: You can create a skill that runs in a subagent with forked context Hooks (score 0) : Tutorial: 06-hooks/ Focus on: Configuration structure (matcher + hooks array), PreToolUse/PostToolUse events, exit codes (0=success, 2=block), JSON input/output format Key exercise: Create a PreToolUse hook that validates Bash commands Done when: A hook blocks dangerous commands before execution Hooks (score 1 — review) : Focus on: All 33 hook events (including PostToolUseFailure, StopFailure, TaskCreated, CwdChanged, FileChanged, PostCompact, Elicitation, ElicitationResult, Setup, UserPromptExpansion, MessageDisplay, PreModelSwitch, PostModelSwitch — the last two added in v2.1.251), 5 hook types (command, http, mcp_tool, prompt, agent — agent hooks are experimental and may change), component-scoped hooks in SKILL.md frontmatter, HTTP hooks with allowedEnvVars, CLAUDE_ENV_FILE for SessionStart/CwdChanged/FileChanged Done when: You can create a prompt-based Stop hook and a component-scoped hook in a skill