{
  "markdown": "# agent-skills\n\nA curated collection of Claude Code **plugins** for interacting with\nthe CloudBlue Connect MCP server. Each plugin is a self-contained folder at\nthe repo root, carrying its own `.claude-plugin/plugin.json` and one or\nmore skills under `skills/`. The repo-level\n`.claude-plugin/marketplace.json` is the catalog Claude Code reads when\nyou register the marketplace.\n\n## Plugins in this repo\n\n| Plugin | Purpose |\n|---|---|\n| [`core`](core/) | Foundation skills for the Connect MCP server. `connect-mcp-setup`: configure any MCP client against the single Connect endpoint, mint a token with the right permissions, diagnose 401/403/empty-catalog problems. `connect-navigator`: locate the right tool family — concept→domain map, VerboseID prefixes, list-tool conventions. |\n| [`fulfillments`](fulfillments/) | Vendor-side triage of inbound fulfillment requests (which lifecycle transition, and why) and distributor/reseller-side subscription operations (inspect, then change / cancel / suspend / resume / renew / adjust / transfer). Skills: `connect-request-triage`, `connect-subscription-ops`. |\n| [`helpdesk`](helpdesk/) | Triage helpdesk cases: read the case and its attachments, pick the correct transition (inquire, pend, resolve, close), draft the partner-facing reply. Drafting is autonomous; sending waits for confirmation. Skill: `connect-helpdesk-triage`. |\n| [`listings`](listings/) | Drive the listing request state machine (submit, deploy, complete, refine, cancel, assign, unassign), pick the target marketplace, and diagnose a stuck listing by naming which side has to act next. Skill: `connect-listing-manager`. |\n| [`pricing`](pricing/) | Drive the price list lifecycle: find a list, open a draft version, update price points, activate or schedule it, plus bulk import of a vendor rate card (XLSX/CSV) into per-point updates. Skill: `connect-pricelist-manager`. |\n| [`products`](products/) | Build a product end to end through the products tools — shell, items, the ordering / fulfillment / configuration parameter phases, templates, version publication — and orchestrate a full launch across products, pricing, marketplaces and listings. Skills: `connect-product-builder`, `connect-product-launch`. |\n| [`usage`](usage/) | Convert vendor billing reports (AWS CUR, Microsoft NCE incl. Azure consumption, Adobe VIP) into CloudBlue Connect Usage Files and submit them through the Connect MCP server. Bundles the `connect-usage-converter` skill. |\n\nMore skills land here as the Connect MCP ecosystem grows.\n\n## Install\n\n### Claude Code (recommended)\n\nRegister the marketplace, then install the skill you want:\n\n```\n/plugin marketplace add cloudblue/agent-skills\n/plugin install usage@cloudblue-agent-skills\n```\n\nUpdates flow through `/plugin update`. To see what's available before\ninstalling, run `/plugin marketplace browse cloudblue-agent-skills`.\n\n### Codex\n\nRegister the marketplace, then add the plugin:\n\n```bash\ncodex plugin marketplace add cloudblue/agent-skills --ref master\ncodex plugin add usage@cloudblue-agent-skills\n```\n\nType `$connect-usage-converter` to invoke the skill explicitly; Codex can\nalso invoke it implicitly when a task matches. Verify with\n`codex plugin list`.\n\n### Other agents\n\nCursor, Gemini CLI, Antigravity, GitHub Copilot, Zed, Pi, Hermes,\nOpenCode, Amp, and any other Agent Skills harness are covered in\n[INSTALL.md](./INSTALL.md). The quick cross-platform route is the\ncommunity [`skills`][skills-cli] CLI:\n\n```bash\nnpx skills add cloudblue/agent-skills\n```\n\n### Development install (symlink)\n\nFor local iteration on the skills themselves:\n\n```bash\ngit clone https://github.com/cloudblue/agent-skills ~/code/agent-skills\nln -s ~/code/agent-skills/usage/skills/connect-usage-converter \\\n      ~/.claude/skills/connect-usage-converter\n```\n\n## Configuration prerequisites\n\nEvery plugin in this repo reaches Connect through one MCP endpoint. The\n[`core`](core/) plugin's `connect-mcp-setup` skill owns that setup for all\nof them — the endpoint, minting a token with the right permissions, the\nclient config, and the 401/403/empty-catalog diagnosis. Install it first:\n\n```\n/plugin install core@cloudblue-agent-skills\n```\n\nThe bare minimum is a `~/.mcp.json` (Claude Code) or equivalent entry\npointing at the MCP endpoint with an `ApiKey` header.\n\n## Repository layout\n\n```\nagent-skills/\n├── .claude-plugin/\n│   └── marketplace.json                       ← Claude Code marketplace catalog (no version)\n├── .agents/plugins/\n│   └── marketplace.json                       ← Codex marketplace catalog\n├── gemini-extension.json                      ← Gemini CLI extension manifest\n├── GEMINI.md                                  ← Gemini context file (imports the skill)\n├── INSTALL.md                                 ← per-harness install instructions\n├── <plugin-name>/                             ← one folder per plugin\n│   ├── .claude-plugin/\n│   │   └── plugin.json                        ← plugin metadata + version\n│   └── skills/\n│       └── <skill-name>/                      ← skill folder\n│           ├── SKILL.md                       ← entry point\n│           └── …                              ← supporting files\n└── README.md\n```\n\nPer-plugin `plugin.json#version` means plugins update independently.\nThe marketplace catalog doesn't carry a version of its own — it's just a\nphone book pointing at each plugin's own metadata. This matches the\nClaude Code plugin spec and the structure used by\n[`hashicorp/agent-skills`][hashicorp-skills].\n\n## Contributing\n\nPlugins should follow the [Claude Code plugin convention][plugin-spec].\nOpen a PR adding:\n\n1. A new top-level folder `<plugin-name>/` with a\n   `.claude-plugin/plugin.json` (must include `name`, `version`,\n   `description`).\n2. One or more skills under `<plugin-name>/skills/<skill-name>/`, each\n   with a `SKILL.md` (`name` / `description` frontmatter + body).\n3. An entry in `.claude-plugin/marketplace.json#plugins[]` pointing at\n   the plugin folder (`\"source\": \"./<plugin-name>\"`).\n4. A row in the **Plugins in this repo** table above.\n\n[plugin-spec]: https://github.com/anthropics/skills\n[hashicorp-skills]: https://github.com/hashicorp/agent-skills\n[skills-cli]: https://www.skills.sh/\n",
  "bytes": 6213,
  "sha": "0288dfa8b3848658939c103b34e60c7430f5e22109226b8d060c49164dc1604a",
  "repo_slug": "cloudblue/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_cloudblue_agent_skills_8636a014/readme"
}