From ab90a8951f7fadd0957823c5913db18b596d871e Mon Sep 17 00:00:00 2001 From: Mathieu Picciolli Date: Mon, 17 Aug 2026 17:17:04 -0400 Subject: [PATCH] refactor: rename plugin pcm to db-editor MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The plugin directory and identifier are renamed from `pcm` to `db-editor`, and the display name across all three manifests is now "DB Editor". `pcm` named the game rather than the plugin's scope, which reads as a claim on the Pro Cycling Manager trademark and leaves no room for further plugins in the marketplace. The marketplace `pcmstack` carries the game context, so each plugin is named for what it does instead: `/plugin install db-editor@pcmstack`. Descriptive mentions of "Pro Cycling Manager" in the manifest descriptions are kept deliberately — they are what the skills trigger on. The skills themselves keep their `pcm-` prefix, which stays useful once skills from several plugins share an agent's context. Co-Authored-By: Claude Opus 5 --- .agents/plugins/marketplace.json | 6 +++--- .claude-plugin/marketplace.json | 4 ++-- AGENTS.md | 14 +++++++------- README.md | 14 +++++++------- .../{pcm => db-editor}/.claude-plugin/plugin.json | 4 ++-- .../{pcm => db-editor}/.codex-plugin/plugin.json | 4 ++-- plugins/{pcm => db-editor}/.mcp.json | 0 plugins/{pcm => db-editor}/assets/app-icon.png | Bin plugins/{pcm => db-editor}/assets/logo.svg | 0 .../skills/pcm-database/SKILL.md | 0 .../references/database-constraints.md | 0 .../pcm-database/references/database-schema.md | 0 .../skills/pcm-database/scripts/open-cdb.sh | 0 .../skills/pcm-startlist/SKILL.md | 0 14 files changed, 23 insertions(+), 23 deletions(-) rename plugins/{pcm => db-editor}/.claude-plugin/plugin.json (92%) rename plugins/{pcm => db-editor}/.codex-plugin/plugin.json (96%) rename plugins/{pcm => db-editor}/.mcp.json (100%) rename plugins/{pcm => db-editor}/assets/app-icon.png (100%) rename plugins/{pcm => db-editor}/assets/logo.svg (100%) rename plugins/{pcm => db-editor}/skills/pcm-database/SKILL.md (100%) rename plugins/{pcm => db-editor}/skills/pcm-database/references/database-constraints.md (100%) rename plugins/{pcm => db-editor}/skills/pcm-database/references/database-schema.md (100%) rename plugins/{pcm => db-editor}/skills/pcm-database/scripts/open-cdb.sh (100%) rename plugins/{pcm => db-editor}/skills/pcm-startlist/SKILL.md (100%) diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json index 1cae473..11c43c2 100644 --- a/.agents/plugins/marketplace.json +++ b/.agents/plugins/marketplace.json @@ -5,13 +5,13 @@ }, "plugins": [ { - "name": "pcm", + "name": "db-editor", "interface": { - "displayName": "Pro Cycling Manager" + "displayName": "DB Editor" }, "source": { "source": "local", - "path": "./plugins/pcm" + "path": "./plugins/db-editor" }, "policy": { "installation": "AVAILABLE", diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 2a6b63b..5d9adfb 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -8,10 +8,10 @@ }, "plugins": [ { - "name": "pcm", + "name": "db-editor", "description": "Explore and edit Pro Cycling Manager game databases (.cdb) — rider ratings, team rosters, contracts, races — and build race startlists exported as the .xml file the game imports. Unofficial, not affiliated with Cyanide Studio or Nacon.", "category": "Developer Tools", - "source": "./plugins/pcm" + "source": "./plugins/db-editor" } ] } diff --git a/AGENTS.md b/AGENTS.md index 1cffb4b..0f68818 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -26,7 +26,7 @@ Key formats and technologies: .claude-plugin/marketplace.json # Claude Code marketplace definition .agents/plugins/marketplace.json # Codex/agents marketplace definition plugins/ - pcm/ + db-editor/ .claude-plugin/plugin.json # Claude Code plugin manifest .codex-plugin/plugin.json # Codex plugin manifest (adds `interface` block) .mcp.json # MCP servers bundled with the plugin (pcm-mcp) @@ -43,7 +43,7 @@ README.md # human-facing overview + quickstart; detailed ``` Skills live **inside a plugin** (`plugins/{plugin}/skills/{skill}/`), not at the repo root. -The only plugin is `pcm`, containing `pcm-database` and `pcm-startlist`. +The only plugin is `db-editor`, containing `pcm-database` and `pcm-startlist`. ## Setup Commands @@ -65,13 +65,13 @@ Install the marketplace locally in Claude Code to test plugin changes: ``` /plugin marketplace add /Users//Dev/agent-skills -/plugin install pcm@pcmstack +/plugin install db-editor@pcmstack ``` Then exercise the skill with realistic prompts (e.g. "who's the best climber in my team?", "build the startlist for the Tour de France") and check that it triggers _and_ that the instructions hold up. The `defaultPrompt` array in -[plugins/pcm/.codex-plugin/plugin.json](plugins/pcm/.codex-plugin/plugin.json) is a good +[plugins/db-editor/.codex-plugin/plugin.json](plugins/db-editor/.codex-plugin/plugin.json) is a good source of test prompts. Prefer the `/skill-creator:skill-creator` skill (if available in your agent environment, @@ -84,7 +84,7 @@ Then apply the repository conventions below to the result. There is no automated test suite. "Testing" here means validation plus behavioural checks: ```bash -bash -n plugins/pcm/skills/pcm-database/scripts/open-cdb.sh # syntax-check scripts +bash -n plugins/db-editor/skills/pcm-database/scripts/open-cdb.sh # syntax-check scripts python3 -m json.tool .json > /dev/null # validate each JSON manifest npx prettier --check "**/*.{md,json}" # formatting ``` @@ -106,7 +106,7 @@ Behavioural checks that matter more than the above: ### Naming Conventions -- **Plugin directory**: `kebab-case` (e.g. `pcm`), matching `name` in both plugin manifests. +- **Plugin directory**: `kebab-case` (e.g. `db-editor`), matching `name` in both plugin manifests. - **Skill directory**: `kebab-case` (e.g. `pcm-database`), matching `name` in its frontmatter. - **SKILL.md**: always uppercase, always this exact filename. - **Scripts**: `kebab-case.sh` or `kebab-case.mjs` (e.g. `open-cdb.sh`). @@ -155,7 +155,7 @@ Consequences worth remembering: - Adding a new plugin means a new `plugins/{name}/` directory **plus** entries in both `.claude-plugin/marketplace.json` and `.agents/plugins/marketplace.json`. - Plugin assets are resolved relative to the plugin directory, which is why `assets/` lives - under `plugins/pcm/` rather than at the repo root. + under `plugins/db-editor/` rather than at the repo root. ## Pull Request Guidelines diff --git a/README.md b/README.md index a6d4049..30f0152 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@
- PCMStack + PCMStack # PCMStack Agent Skills @@ -28,11 +28,11 @@ You ▸ Build the startlist for Almería — 20 teams, sprinters up front ## Install -The repository is a marketplace containing a single plugin, `pcm`. In **Claude Code**: +The repository is a marketplace containing a single plugin, `db-editor`. In **Claude Code**: ``` /plugin marketplace add PCMStack/agent-skills -/plugin install pcm@pcmstack +/plugin install db-editor@pcmstack ``` Then just ask. Skills trigger on their own when a request matches — no command to remember. @@ -41,7 +41,7 @@ Then just ask. Skills trigger on their own when a request matches — no command Other agents The skills follow the portable `SKILL.md` format, so any agent that reads Agent Skills can -use them. Point your agent at `plugins/pcm/skills/`, or clone the repository and add it as a +use them. Point your agent at `plugins/db-editor/skills/`, or clone the repository and add it as a local marketplace: ``` @@ -49,7 +49,7 @@ local marketplace: ``` Codex-compatible manifests live in `.agents/plugins/marketplace.json` and -`plugins/pcm/.codex-plugin/plugin.json`. +`plugins/db-editor/.codex-plugin/plugin.json`. @@ -111,7 +111,7 @@ manifests, read by another agent at runtime. ``` .claude-plugin/marketplace.json # Claude Code marketplace .agents/plugins/marketplace.json # Codex/agents marketplace -plugins/pcm/ +plugins/db-editor/ .claude-plugin/plugin.json # plugin manifest .codex-plugin/plugin.json # plugin manifest (Codex, adds `interface`) .mcp.json # bundled MCP servers @@ -130,7 +130,7 @@ realistic prompts and check they trigger on paraphrases — a description that m Validation before opening a PR: ```bash -bash -n plugins/pcm/skills/pcm-database/scripts/open-cdb.sh # syntax-check scripts +bash -n plugins/db-editor/skills/pcm-database/scripts/open-cdb.sh # syntax-check scripts python3 -m json.tool .json > /dev/null # validate manifests npx prettier --check "**/*.{md,json}" # formatting ``` diff --git a/plugins/pcm/.claude-plugin/plugin.json b/plugins/db-editor/.claude-plugin/plugin.json similarity index 92% rename from plugins/pcm/.claude-plugin/plugin.json rename to plugins/db-editor/.claude-plugin/plugin.json index 7ff67c0..998c06f 100644 --- a/plugins/pcm/.claude-plugin/plugin.json +++ b/plugins/db-editor/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { - "name": "pcm", - "displayName": "Pro Cycling Manager", + "name": "db-editor", + "displayName": "DB Editor", "version": "0.1.0", "description": "Explore and edit Pro Cycling Manager game databases (.cdb) — rider ratings, team rosters, contracts, races — and build race startlists exported as the .xml file the game imports. Unofficial, not affiliated with Cyanide Studio or Nacon.", "author": { diff --git a/plugins/pcm/.codex-plugin/plugin.json b/plugins/db-editor/.codex-plugin/plugin.json similarity index 96% rename from plugins/pcm/.codex-plugin/plugin.json rename to plugins/db-editor/.codex-plugin/plugin.json index e82af03..928ee63 100644 --- a/plugins/pcm/.codex-plugin/plugin.json +++ b/plugins/db-editor/.codex-plugin/plugin.json @@ -1,5 +1,5 @@ { - "name": "pcm", + "name": "db-editor", "version": "0.1.0", "description": "Explore and edit Pro Cycling Manager game databases (.cdb) — rider ratings, team rosters, contracts, races — and build race startlists exported as the .xml file the game imports. Unofficial, not affiliated with Cyanide Studio or Nacon.", "author": { @@ -22,7 +22,7 @@ "skills": "./skills/", "mcpServers": "./.mcp.json", "interface": { - "displayName": "CDB Editor", + "displayName": "DB Editor", "shortDescription": "Edit Pro Cycling Manager databases and build race startlists", "longDescription": "Community tooling for Pro Cycling Manager. Open and edit the game database (.cdb) — rider ratings, team rosters, contracts, races — via the pcm-mcp MCP server or a lossless CDB to SQLite conversion, and compose race startlists exported as the .xml file the game imports. Unofficial project, not affiliated with or endorsed by Cyanide Studio or Nacon.", "developerName": "PCMStack", diff --git a/plugins/pcm/.mcp.json b/plugins/db-editor/.mcp.json similarity index 100% rename from plugins/pcm/.mcp.json rename to plugins/db-editor/.mcp.json diff --git a/plugins/pcm/assets/app-icon.png b/plugins/db-editor/assets/app-icon.png similarity index 100% rename from plugins/pcm/assets/app-icon.png rename to plugins/db-editor/assets/app-icon.png diff --git a/plugins/pcm/assets/logo.svg b/plugins/db-editor/assets/logo.svg similarity index 100% rename from plugins/pcm/assets/logo.svg rename to plugins/db-editor/assets/logo.svg diff --git a/plugins/pcm/skills/pcm-database/SKILL.md b/plugins/db-editor/skills/pcm-database/SKILL.md similarity index 100% rename from plugins/pcm/skills/pcm-database/SKILL.md rename to plugins/db-editor/skills/pcm-database/SKILL.md diff --git a/plugins/pcm/skills/pcm-database/references/database-constraints.md b/plugins/db-editor/skills/pcm-database/references/database-constraints.md similarity index 100% rename from plugins/pcm/skills/pcm-database/references/database-constraints.md rename to plugins/db-editor/skills/pcm-database/references/database-constraints.md diff --git a/plugins/pcm/skills/pcm-database/references/database-schema.md b/plugins/db-editor/skills/pcm-database/references/database-schema.md similarity index 100% rename from plugins/pcm/skills/pcm-database/references/database-schema.md rename to plugins/db-editor/skills/pcm-database/references/database-schema.md diff --git a/plugins/pcm/skills/pcm-database/scripts/open-cdb.sh b/plugins/db-editor/skills/pcm-database/scripts/open-cdb.sh similarity index 100% rename from plugins/pcm/skills/pcm-database/scripts/open-cdb.sh rename to plugins/db-editor/skills/pcm-database/scripts/open-cdb.sh diff --git a/plugins/pcm/skills/pcm-startlist/SKILL.md b/plugins/db-editor/skills/pcm-startlist/SKILL.md similarity index 100% rename from plugins/pcm/skills/pcm-startlist/SKILL.md rename to plugins/db-editor/skills/pcm-startlist/SKILL.md