puzzle9900-plugins

puzzle9900-claude-plugin for Claude Code

A Claude Code plugin that provides custom skills, agents, and hooks to extend your development workflow.

What is This?

This is a Claude Code plugin that provides custom skills, agents, and hooks. It integrates directly into Claude Code to enhance your AI-assisted development experience.

Plugin vs Marketplace Plugin

Type	Description
Plugin	A local directory that extends Claude Code with custom functionality
Marketplace Plugin	The same plugin, but published to a marketplace for discovery and installation

This repository serves as both:

• A standalone plugin you can use locally during development
• A marketplace plugin that can be installed via Claude Code's plugin system

Installation

Option 1: Install from Marketplace (Recommended)

# Add the marketplace
/plugin marketplace add puzzle9900/puzzle9900-claude-plugin

# Install the plugin
/plugin install puzzle9900-claude-plugin

Option 2: Local Development

Clone and use directly:

git clone https://github.com/Puzzle9900/puzzle9900-claude-plugin.git
cd your-project
claude --plugin-dir ../puzzle9900-claude-plugin

Option 3: Global Install for Local Development

Register the plugin globally so its skills are available in every Claude Code session. Uses a cache symlink so that git pull, new skills, and edited skills are picked up on the next session restart — no version bump or reinstall needed.

Automated setup (recommended)

Run the setup script from the cloned repo:

cd puzzle9900-claude-plugin
./plugins/puzzle9900-claude-plugin/skills/generic-setup-claude-plugin-locally/setup-local.sh

This registers the plugin, creates the cache symlink, and verifies everything in one step.

Manual setup

If you prefer to set things up manually, follow these steps:

1. Create the plugins directory (if it doesn't exist):

mkdir -p ~/.claude/plugins

2. Register the marketplace in ~/.claude/settings.json:

Add these entries (merge into your existing file — don't overwrite other keys). The marketplace path points to the repo root (where marketplace.json lives):

{
  "enabledPlugins": {
    "puzzle9900-claude-plugin@puzzle9900-plugins": true
  },
  "extraKnownMarketplaces": {
    "puzzle9900-plugins": {
      "source": {
        "source": "directory",
        "path": "/absolute/path/to/puzzle9900-claude-plugin"
      }
    }
  }
}

3. Register in ~/.claude/plugins/known_marketplaces.json:

This is the step most setups miss — without it the plugin silently fails to load outside the plugin directory.

{
  "puzzle9900-plugins": {
    "source": {
      "source": "directory",
      "path": "/absolute/path/to/puzzle9900-claude-plugin"
    },
    "installLocation": "/absolute/path/to/puzzle9900-claude-plugin",
    "lastUpdated": "2026-01-15T10:30:00.000Z"
  }
}

4. Register in ~/.claude/plugins/installed_plugins.json:

The installPath points to the plugin subfolder, not the repo root:

{
  "version": 2,
  "plugins": {
    "puzzle9900-claude-plugin@puzzle9900-plugins": [
      {
        "scope": "user",
        "installPath": "/absolute/path/to/puzzle9900-claude-plugin/plugins/puzzle9900-claude-plugin",
        "version": "1.2.0",
        "installedAt": "2026-01-15T10:30:00.000Z",
        "lastUpdated": "2026-01-15T10:30:00.000Z"
      }
    ]
  }
}

5. Create the cache symlink (critical step):

Claude Code always reads plugins from its cache directory, not from installPath. Without this symlink, new or changed skills won't appear even after restarting. The symlink points to the plugin subfolder:

mkdir -p ~/.claude/plugins/cache/puzzle9900-plugins/puzzle9900-claude-plugin
rm -rf ~/.claude/plugins/cache/puzzle9900-plugins/puzzle9900-claude-plugin/1.2.0
ln -s /absolute/path/to/puzzle9900-claude-plugin/plugins/puzzle9900-claude-plugin ~/.claude/plugins/cache/puzzle9900-plugins/puzzle9900-claude-plugin/1.2.0

Verify the symlink works:

ls -la ~/.claude/plugins/cache/puzzle9900-plugins/puzzle9900-claude-plugin/
# Should show: 1.2.0 -> /absolute/path/to/puzzle9900-claude-plugin/plugins/puzzle9900-claude-plugin

6. Restart Claude Code — skills are available immediately. Any change to the plugin repo (new skills, edits, git pull) will be picked up on the next session restart with no further action needed.

Usage

Once installed, access skills with the /puzzle9900-claude-plugin: prefix:

# List available skills
/puzzle9900-claude-plugin:generic-help

# Example skills (add your own!)
/puzzle9900-claude-plugin:generic-spec
/puzzle9900-claude-plugin:generic-spec-capture
/puzzle9900-claude-plugin:generic-contributor-jira-context

Repository Structure