how-this-repo-works

What problem does it solve?

This skill explains the full lifecycle and propagation path for Claude Code plugins in the nsheaps/ai-mktpl repository, making it easy to understand how source changes become installed plugin versions for users. It helps reduce confusion when version bumps, marketplace.json drift, or cache issues prevent updates from appearing in user sessions.

Core Features & Use Cases

• End-to-end flow mapping: Describes developer edits, PR validation, CD version bumps, marketplace.json regeneration, commits, and push semantics.
• Operational debugging: Guides investigation of detect-plugin-changes output, release-it bumps, CI/CD job behavior, and local vs GitHub marketplace differences.
• Tooling and configuration reference: Details the roles of mise, just, yarn, release-it, GitHub Actions, plugin.json schema, and the Claude Code plugin cache.
• Use Case: When a user reports that a plugin update is not active, follow the pipeline steps to identify whether the issue is in CI validation, version bumping, marketplace generation, or client cache resolution.

Quick Start

Explain step-by-step how a change to plugins/scm-utils in nsheaps/ai-mktpl moves from a merged PR to being served from ~/.claude/plugins/cache for end users.