Learning Opportunities: A Claude Code and Codex Skill for Deliberate Skill Development

Build your expertise, not just your projects.

This skill uses an adaptive "dynamic textbook" approach to help you integrate science-based expertise building exercises while doing agentic coding.

When you complete architectural work (new files, schema changes, refactors), Claude offers optional 10-15 minute learning exercises grounded in evidence-based learning science. The exercises use techniques like prediction, generation, retrieval practice, and spaced repetition to provide you with semi-worked examples from across your own project work.

Pairs well with Learning-Goal, a skill that guides you through semi-structured, interactive learning goal-setting using the technique of Mental Contrasting with Implementation Intentions (MCII), an evidence-based exercise.

Use Cases

This skill is designed for developers using agentic coding tools (Claude Code, Codex) who want to build deeper expertise beyond just completing projects. It is especially useful when working on projects that involve multiple unfamiliar languages, techniques, or architectural patterns.

Why You Might Want to Experiment with This Skill

AI coding tools can create specific risks for decreasing users' engagement in learning by introducing inefficient learning habits. These effects can be anticipated based on several foundational science-backed learning principles:

1. Generation effect: Accepting generated code and decreasing generating one's own code can skip the active processing that builds understanding.
2. Fluency illusion: Clean generated code can be perceived as more understood than it truly is; likewise, easily accessible knowledge from search can promote the illusion of knowledge and the illusion of more complete mental models.
3. Spacing effect: Machine velocity can push users toward constant cramming and long production sessions without the cadence, reflection and spacing of learning that leads to longer-term retention.
4. Metacognition: Fast workflows often don't leave room to monitor learning and develop schema representation as well as a user's sense of their own level of relative expertise and knowledge when working with novel technology.
5. Testing and retrieval: Agentic models push toward giving complete answers, which could result in users taking fewer opportunities to benefit from self-testing and retrieving specific components of new knowledge, which strengthens retention.

The techniques in SKILL.md are designed to counteract these risks by reintroducing:

• Active generation (predictions, explanations, sketches)
• Retrieval practice (check-ins, teach-it-back, self-testing)
• Deliberate pauses (spacing, reflection)
• Explicit metacognition (self-assessment, gap identification)

This skill interrupts that pattern by reminding you to consider investing in reflection and learning. It introduces a different "mode" of interacting with Claude, which will intentionally feel different than highly fluent and fast agentic coding in the service of helping you reflect and explore your generated work. This skill may be particularly useful for users who are experimenting with developing discrete projects with agentic coding that involve multiple unfamiliar languages, techniques, or architectural patterns.

Core Capabilities

• Adaptive Learning Exercises: After completing architectural work (new files, schema changes, refactors, etc.), Claude optionally offers a 10-15 minute learning exercise.
• Variety of Exercise Types: Includes Prediction → Observation → Reflection, Generation → Comparison, Trace the path, Debug this, Teach it back, Retrieval check-in.
• Science-Based Design: Exercises leverage generation effect, retrieval practice, spaced repetition, and metacognition to counteract common learning risks in agentic coding.
• Active Thinking Design: Claude pauses and waits for your input rather than providing answers, promoting active mental effort.
• Customizable: You can adjust trigger conditions, exercise content, soft cap, and other parameters to match your workflow and expertise level.
• Pairs with Learning-Goal: Use together with the Learning-Goal skill for structured learning goal setting.

How It Works

After you complete significant work (which you can self-define, but I've suggested: creating new files or modules, database schema changes, architectural decisions or refactors, implementing unfamiliar patterns, any work where the user asked "why" questions during development. The key idea is to find a moment in your personal flow where a learning opportunity is most beneficial) Claude will ask:

"Would you like to do a quick learning exercise on [topic]? About 10-15 minutes."

If you accept, Claude runs you through an interactive exercise. A key design principle: Claude pauses and waits for your input rather than answering its own questions. This can feel frustrating, but this pushes against Claude's default to always provide the full answer and encourages your own mental effort and learning. You may encounter and need to design against Claude's defaults to provide the complete answer; please feel free let me know if you find gotchas or conflicts in your own workflow that you think will generalize to others so that I can incorporate in the Skill to improve this (e.g., I learned we needed to suppress prompt suggestions).

Exercise Types

• Prediction → Observation → Reflection: What do you expect to happen? Now let's see. What surprised you?
• Generation → Comparison: Sketch how you'd approach this before seeing the implementation
• Trace the path: Walk through execution step by step, predicting each transition
• Debug this: What would go wrong here, and why?
• Teach it back: Explain this component as if onboarding a new developer
• Retrieval check-in: At the start of a session, what do you remember from last time?

Will Not Suggest Learning Opportunities When...

Two suppression conditions are currently suggested which can be adapted to your workflow needs. Claude will not prompt learning opportunities when:

• You've already declined an exercise this session
• You've completed 2 exercises this session

The Science Behind It & Resources

The exercises draw from well-established findings in learning science, along with substantive research on typical learner misconceptions. Design choices also draw from multiple qualitative interviews with developers about what aspects of rapid agentic coding they find most frustrating, worrisome, or difficult when it comes to their own learning and development.

See PRINCIPLES.md for detailed explanations which can help you develop new exercise types or simply learn more about strategies to help your own learning.

Measure This, A Lightweight Playbook for Making A Team Experiment Visible

If you're trying this skill with your team, you can layer on a lightweight pre/post measurement to make the experiment more visible and valued in your organization.

MEASURE-THIS.md is a companion playbook that includes:

• A curated set of validated survey items from our peer-reviewed research on developer thriving and AI skill threat, ready to copy into a Google Form or team channel
• Guidance on what to do (and not do) with your results including why variance matters as much as averages, and some guardrails on how I think about these types of measures
• A "team boast" template a fill-in-the-blank paragraph for packaging your experiment into an email to leadership, grounded in real research
• Claude.md nudges for statistical rigor if you want to use Claude for more complex analysis, these nudges help guard against common AI-assisted statistical mistakes

The measures are free and open access under a CC-BY-SA 4.0 license. For the full set of measures and design notes, see the AI Skill Threat open access measures supplement and the Developer Thriving open access measures supplement.

Customization

This skill can be significantly refined and adapted. You might want to:

• Include information about your own technical expertise and existing knowledge to start the exercises at the right level (e.g. known languages, learning goals)
• Prompt Claude to include insights from the learning opportunities into your project Claude.md
• Adjust trigger conditions for your workflow
• Add project-specific examples to the exercises
• Change the soft cap on exercises per session
• Add domain-specific retrieval check-in questions
• Explore adding evaluation checks to assess how successfully this skill is fulfilling its instructions