Codex Self-Assessment
Master your Codex skills with a personalized learning journey.
This interactive assessment identifies your current expertise level and generates a custom learning path tailored to your gaps and goals.
How It Works
Step 1: Choose Your Mode
Quick Mode (5 min)
- 10 questions across 10 topics
- Best for: Quick skill check, understanding your general level
- Output: Overall profile (Beginner/Intermediate/Advanced) + top 2-3 gaps
Comprehensive Mode (20 min)
- 20 questions (2 per topic)
- Best for: Detailed mastery assessment, planning team training
- Output: Per-topic scores + detailed learning path + 3 practice projects
Step 2: Answer Questions
Questions cover:
- Practical usage (how to do things)
- Decision-making (when to use what)
- Architecture patterns (why things work)
- Production best practices (security, performance, scaling)
Each question has:
- 4 options (A-D)
- Immediate feedback on correct answer
- Link to relevant guide section
Step 3: Get Your Profile
Quick Mode Output:
╔═══════════════════════════════════════════════╗ ║ Your Profile: Intermediate Developer ║ ╠═══════════════════════════════════════════════╣ ║ Overall Score: 14/20 ║ ║ Level: Intermediate (strong) ║ ╠═══════════════════════════════════════════════╣ ║ Immediate Gaps: ║ ║ • MCP Servers (5/5 topics weak) ║ ║ • Advanced Patterns (4/5 weak) ║ ║ • Hooks (3/5 partially weak) ║ ║ ║ ║ → Recommended learning time: 4-6 hours ║ ╚═══════════════════════════════════════════════╝
Comprehensive Mode Output:
╔═══════════════════════════════════════════════════════════════╗ ║ Detailed Mastery Profile ║ ╠═══════════════════════════════════════════════════════════════╣ ║ ║ ║ 01 Quick Start ████░░░░░░ 8/10 Proficient ║ ║ 02 Core Concepts ██████░░░░ 6/10 Proficient ║ ║ 03 Memory & Settings ██████░░░░ 6/10 Proficient ║ ║ 04 Agents ████░░░░░░ 4/10 Basic ║ ║ 05 Skills ████░░░░░░ 4/10 Basic ║ ║ 06 Commands ██████░░░░ 6/10 Proficient ║ ║ 07 Hooks ██░░░░░░░░ 2/10 None ║ ║ 08 MCP Servers ██░░░░░░░░ 2/10 None ║ ║ 09 Advanced Patterns ░░░░░░░░░░ 0/10 None ║ ║ 10 Security ███░░░░░░░ 3/10 Basic ║ ║ ║ ║ OVERALL: Intermediate (14/100 points) ║ ╚═══════════════════════════════════════════════════════════════╝
Step 4: Get Your Learning Path
Based on your scores, you get:
Prioritized learning sequence (respects dependencies):
- Topics ordered by weakness + importance
- Prerequisites shown (you can't skip foundations)
- Time estimates for each topic (sums only what you need)
- Templates and examples linked to each topic
Example path for Intermediate developer:
Phase 1: Hooks Fundamentals (2 hours) → Read: guide/ultimate-guide.md#7-hooks → Try: examples/hooks/event-driven-formatting.sh → Quiz: /lesson-quiz 07-hooks Phase 2: MCP Integration (3 hours) → Read: guide/ultimate-guide.md#8-mcp-servers → Try: examples/mcp-configs/github-integration.json → Quiz: /lesson-quiz 08-mcp-servers Phase 3: Advanced Patterns (4 hours) → Read: guide/ultimate-guide.md#9-advanced-patterns → Practice: 3 real-world projects (see below) → Quiz: /lesson-quiz 09-advanced-patterns
3 Practice Projects Based on your profile, you get targeted exercises:
- Project 1: Combine 2-3 topics you're weak in
- Project 2: Real-world workflow integration
- Project 3: Team/production scenario
Getting Started
Quick Assessment
/self-assessment quick
Full Assessment
/self-assessment comprehensive
Options
/self-assessment quick --verbose # Show explanations /self-assessment comprehensive --save # Save results to file
What You Learn
This assessment is designed to identify:
Fundamental Gaps
- Core interaction loops you haven't tried
- Essential features you've overlooked
- Mental model misconceptions
Decision-Making Blind Spots
- When to use agents vs skills vs commands
- Which hook event to use for which problem
- MCP server selection for your needs
Production Readiness
- Security best practices
- Performance optimization patterns
- Scaling multi-agent systems
- Team configuration and governance
After Your Assessment
Immediate Actions
- See your profile — Understand your current mastery level
- Identify gaps — Know exactly what to learn next
- Get a learning path — Personalized, dependency-aware sequence
- Practice — 3 targeted projects matching your level
Recommended Follow-up Skills
/lesson-quiz [topic]— Quiz yourself on specific topics/audit-agents-skills— Audit your own config quality/Codex-md— Manage your AGENTS.md configuration
Integration with Learning Path
After assessment, the /lesson-quiz skill provides per-module verification:
- Answer 5 questions per module
- Get instant feedback on weak areas
- Unlock next module when ready
Scoring & Profiles
Junior Developer (0-6 points)
- Just installed Codex
- Know basic commands and workflows
- Haven't touched memory/agents/hooks yet
- Next step: Core Concepts + Memory module
Intermediate Developer (7-13 points)
- Using Codex daily
- Comfortable with AGENTS.md and basic agents
- Exploring skills and commands
- Some hook usage, no MCP servers
- Next step: Deep MCP + Advanced Patterns
Advanced Developer (14-20 points)
- Master multi-agent orchestration
- Production-grade security and scaling
- Custom skills and complex hooks
- MCP server expertise
- Next step: Team training, enterprise patterns
Tips for Better Results
- Answer honestly — Don't guess, skip unknown questions
- Review explanations — Each question has a guide link
- Revisit before level-up — Retake assessment after learning new topics
- Share results — Use your profile to coordinate with your team
Need Help?
- Questions about the assessment? → Check
/help self-assessment - Want to discuss results? → See
guide/roles/learning-with-ai.md - Found an error? → Report it on GitHub Issues
Ready to master Codex? Start with /self-assessment quick now.
