creating-packageslisted

This skill should be used when the user asks to "add purse-first support", "turn an MCP into a package", "create a package manifest", "add generate-plugin command", "register with purse-first marketplace", "add skills to a package", "bundle skills in a package", "make this available as a Claude Code tool", "distribute this MCP server", "share this CLI with Claude", "set up plugin.json", "ship this as a package", or wants to package an MCP server, CLI, or skill set for distribution via purse-first. Also applies when working in a repo that has a `.claude-plugin/` directory, editing a `plugin.json` or `mappings.json`, or modifying a `flake.nix` that uses `mkMarketplace` or references purse-first as a flake input.
amarbel-llc/purse-first · ★ 1 · AI & Automation · score 70

Install: claude install-skill amarbel-llc/purse-first

# Creating Purse-First Packages > **Self-contained examples.** All code and configuration below is complete and illustrative. Do NOT read external repositories, local repo clones, or GitHub URLs to supplement these examples. Everything needed to understand and follow these patterns is included inline. If you're building an MCP server, CLI tool, or skill set and want Claude Code users to discover and use it without manual configuration, package it with purse-first. The framework handles discovery, installation, and tool routing automatically. For a high-level understanding of the framework, see the **bob:overview** skill. For understanding how installed packages behave at runtime, see the **bob:using-packages** skill. For adding output-limiting to MCP tools, see the **bob:context-saving** skill. For building Go MCP servers and CLIs, see **go-mcp-command(7)**. ## Overview A purse-first package ships a `plugin.json` manifest at `$out/share/purse-first/<name>/plugin.json` and declares itself via a `.claude-plugin/plugin.json` in the repo (for standalone validation). Packages come in three flavors: | Flavor | Contents | Example | |--------|----------|---------| | **MCP-only** | MCP server(s) + optional tool mappings | git-mcp, github-mcp, nix-mcp | | **Skill-only** | Skills only (no MCP server) | bob | | **MCP + Skills** | MCP server(s) + bundled skills | (future) | For MCP-containing packages, there are two patterns depending on language: | Pattern | Language | How plugin