Skip to content

CLAUDE.md

Latest commit

 

History

History
55 lines (39 loc) · 1.81 KB

CLAUDE.md

File metadata and controls

55 lines (39 loc) · 1.81 KB

Learning Opportunities

Last verified: 2026-03-03

What This Is

A Claude Code plugin packaging science-based learning exercises for deliberate skill development during AI-assisted coding. Author: Dr. Cat Hicks. License: CC-BY-4.0.

Project Structure

  • .claude-plugin/marketplace.json - Marketplace catalog (repo root is the marketplace)
  • .agents/plugins/marketplace.json - Codex marketplace catalog
  • learning-opportunities/ - The skill plugin
    • .claude-plugin/plugin.json - Plugin manifest
    • .codex-plugin/plugin.json - Codex plugin manifest
    • skills/learning-opportunities/ - The skill (SKILL.md + resources)
  • learning-opportunities-auto/ - The auto-prompting hook plugin (requires learning-opportunities)
    • .claude-plugin/plugin.json - Plugin manifest
    • .codex-plugin/plugin.json - Codex plugin manifest
    • hooks/post-tool-use.sh - PostToolUse hook (bash)
  • orient/ - The orientation generator plugin
    • .claude-plugin/plugin.json - Plugin manifest
    • .codex-plugin/plugin.json - Codex plugin manifest
    • skills/orient/ - The skill (SKILL.md)
  • CHANGELOG.md - Release history

Releasing a New Version

Each plugin has its own version. When releasing, update the version in four places atomically:

  1. <plugin>/.claude-plugin/plugin.json — bump version
  2. <plugin>/.codex-plugin/plugin.json — bump version
  3. .claude-plugin/marketplace.json — bump the matching plugin entry's version
  4. CHANGELOG.md — add entry at top, under the # Changelog heading

Use semver. All versioned files must show the same version string for the plugin being released. Commit them together.

Changelog format

## <plugin-name> X.Y.Z

Brief description.

**New:**
- Additions

**Changed:**
- Modifications

**Fixed:**
- Bug fixes

Only include sections that apply.
⚡