Learning Opportunities

Learning Opportunities: A Claude Code 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](https://github.com/DrCatHicks/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.

Installation

This repository is a [Claude Code plugin marketplace](https://docs.claude.com/en/docs/claude-code/plugins). To install:

1. Add the marketplace:

   /plugin marketplace add https://github.com/DrCatHicks/learning-opportunities.git

2. Install the plugin:

   /plugin install learning-opportunities@learning-opportunities

3. Restart Claude Code to activate

For more on Claude Code plugins, see the [plugin documentation](https://docs.claude.com/en/docs/claude-code/plugins).

Automatic Prompting (Optional)

Linux and macOS users can install `learning-opportunities-auto` alongside `learning-opportunities` to have Claude automatically consider offering an exercise after each git commit. Windows users can use it too — [a little setup is required](./learning-opportunities-auto/README.md#windows-setup).

Get Repo Orientation Lessons (Optional)

If you're learning a new repo you can create an `orientation.md` file with suggested lessons using the `orient` skill. The orientation approach applies strategies from empirical research on prog