acquire-codebase-knowledge

The Cursed (and Highly Fashionable) Lucky Hat Plugin Marketplace

Well, well, well. Look what you’ve stumbled upon, you curious little sausage.

This, my friends, is the Lucky Hat. Now, my sweet lady wife keeps telling me it’s cursed—made of the finest witch's skin, she claims, complete with a rather unfortunate puckered opening on the back. But I say, look at the silhouette! It is exquisite. It is a local plugin bazaar, a digital cabinet of curiosities, designed to bestow rather magnificent skills upon your mechanical companions: Codex, Copilot CLI, and Claude Code.

Be warned: This grand collection of digital witchcraft is licensed under the GNU GPL v3. See the LICENSE if you are a pedantic bore or a magistrate.

The Cabinet of Curiosities (Included Plugins)

Within this marvelous hat, we have stuffed all manner of tricks and treats:

• 71 Splendid Curiosities: Ready to be summoned from the depths of .agents/plugins/marketplace.json.
• 75 Local Novelties: Freshly plucked from the orchards of ../agent-skills/skills. They are static snapshots, mind you. No live, restless spirits here.
• Consolidation of the Arts: To avoid vulgar duplication, I have personally consolidated four overlapping pairs of plugins (with the help of some minor physical persuasion):
  • git-worktrees has been soundly beaten into worktrunk.
  • integration-testing-http has surrendered its title to testing-workflows (though we kept api-smoke-validation for when you need a quick, hot validation check).
  • plan-review-loop has been trimmed down to the much more elegant plan-review.
  • to-issues has been rebranded as to-prd. Because structure is sexy.

The Anatomy of the Hat (Layout)

Should you wish to poke around in my private drawers, here is where everything resides:

• plugins/ – The raw, throbbing heart of the local plugins.
• .agents/plugins/marketplace.json – The absolute, undeniable source of truth. The master registry of our little marketplace.
• marketplace.json – The public listing for any generic, wandering clients.
• .github/plugin/marketplace.json – For the Copilot crowd.
• .claude-plugin/marketplace.json – For those who prefer Claude’s particular brand of intelligence.

Feeding the Beast (How to Install)

To teach your thinking boxes how to wear the hat, you must run these incantations in your terminal. Gizmo! Type these commands!

Step 1: Tell the machine where the magic comes from

# Codex (the classic)
codex plugin marketplace add matt-riley/lucky-hat --ref main

# Copilot CLI (if you must)
copilot plugin marketplace add matt-riley/lucky-hat

# Claude Code (the fancy new fellow)
claude plugin marketplace add matt-riley/lucky-hat

Step 2: Pluck the fruits from the hat

Once the marketplace is added, you can start installing. Let’s start with a rather marvelous context map, shall we?

# Install the map so your agent knows where on Earth it is
codex plugin add context-map@lucky-hat
copilot plugin install context-map@lucky-hat
claude plugin install context-map@lucky-hat

# And a few other delectable treats
codex plugin add code-intelligence@lucky-hat
codex plugin add api-smoke-validation@lucky-hat
codex plugin add test-driven-development@lucky-hat
codex plugin add worktrunk@lucky-hat
codex plugin add plan-review@lucky-hat
codex plugin add to-prd@lucky-hat

Note: If you are looking for specific names, consult the grand ledger at .agents/plugins/marketplace.json.

A Crucial Warning!

After you have installed these skills or given them a fresh polish, you must start a completely new Codex thread before testing them. These digital brains are like vampires: they need a clean, fresh invitation to drink the new code. Do not forget, or you shall have absolutely no luck at all!