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