Fix Gemini skills and agents missing since 1.2.0

Author: MajidAbuRmila

.githooks/pre-commit

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+#
+# Pre-commit hook: if any source skill/agent file under plugins/cpln/ is
+# staged for commit, regenerate the skills/ and agents/ mirrors at the
+# repo root and stage the result. This keeps the Gemini-facing mirrors
+# in sync with the Claude/Codex/Cursor source of truth without anyone
+# having to remember to run the script.
+#
+# Enable once per clone with:
+#   git config core.hooksPath .githooks
+
+set -euo pipefail
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+
+if git diff --cached --name-only --diff-filter=ACMRD \
+  | grep -qE '^plugins/cpln/(skills|agents)/'; then
+  "$REPO_ROOT/scripts/sync-gemini-content.sh" >/dev/null
+  git add "$REPO_ROOT/skills" "$REPO_ROOT/agents"
+fi

.github/workflows/release.yml

@@ -79,6 +79,9 @@ jobs:
             plugins/cpln/.claude-mcp.json \
             plugins/cpln/hooks/cpln-hooks.json
 
+      - name: Validate Gemini skills/agents mirror is in sync
+        run: scripts/sync-gemini-content.sh --check
+
       - name: Extract release notes from CHANGELOG
         id: notes
         env:

CHANGELOG.md

@@ -6,13 +6,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/) and this
 
 ## [Unreleased]
 
-### Added
-
-### Changed
-
 ### Fixed
 
-### Removed
+- Gemini CLI skills and agents missing since 1.2.0.
 
 ## [1.3.1] - 2026-05-13
 

CLAUDE.md

@@ -7,8 +7,9 @@ End-user install and capability docs live in `README.md`. Development principles
 | Path | Purpose |
 | --- | --- |
 | `plugins/cpln/` | The plugin itself. Claude, Codex, and Cursor all resolve this as their plugin root. |
-| `plugins/cpln/skills/<name>/SKILL.md` | One domain skill per folder. Companion files (`*.md`) load on demand. |
-| `plugins/cpln/agents/<name>.md` | One guided workflow per file. Reference docs live under `plugins/cpln/references/<name>/`. |
+| `plugins/cpln/skills/<name>/SKILL.md` | One domain skill per folder. Companion files (`*.md`) load on demand. Source of truth — mirrored to `skills/` at the repo root for Gemini by `scripts/sync-gemini-content.sh`. |
+| `plugins/cpln/agents/<name>.md` | One guided workflow per file. Reference docs live under `plugins/cpln/references/<name>/`. Source of truth — mirrored to `agents/` at the repo root for Gemini by `scripts/sync-gemini-content.sh`. |
+| `skills/`, `agents/` | **Generated mirrors. Do not edit.** Refreshed automatically by the pre-commit hook in `.githooks/pre-commit` whenever a file under `plugins/cpln/{skills,agents}/` is staged. Also refreshed by `scripts/bump-version.sh` and validated on CI. |
 | `plugins/cpln/commands/<name>.md` | Slash command for Claude / Codex / Cursor. Each `.md` has a matching `.toml` at the repo root for Gemini — keep the pair aligned by name and description. |
 | `commands/<name>.toml` | Slash command for Gemini. Gemini discovers commands at the extension root (the repo root), not under `plugins/cpln/`. Authored separately from the matching `.md` because the `.toml` `prompt` is a tight model instruction while the `.md` body is user docs. |
 | `plugins/cpln/rules/*.md` | Guardrails and manifest references. Files with `alwaysApply: true` are injected into every session by the `SessionStart` hook in `plugins/cpln/hooks/cpln-hooks.json`. |
@@ -54,6 +55,12 @@ claude --plugin-dir ./plugins/cpln
 
 Loads the plugin from this working tree for one session. Edits to skills, agents, commands, rules pick up on `/reload-plugins`; edits to `plugin.json`, hooks, or MCP configs require restarting the session.
 
+Enable the pre-commit hook once per clone so the Gemini-facing `skills/` and `agents/` mirrors stay in sync automatically:
+
+```bash
+git config core.hooksPath .githooks
+```
+
 ## Validation
 
 ```bash

CONTRIBUTING.md

@@ -22,11 +22,20 @@ jq empty \
   plugins/cpln/.codex-plugin/mcp.json \
   plugins/cpln/.claude-mcp.json \
   plugins/cpln/hooks/cpln-hooks.json
+scripts/sync-gemini-content.sh --check
 gemini extensions validate .
 ```
 
 When changing a slash command, edit both the `.md` under `plugins/cpln/commands/` (read by Claude / Codex / Cursor) and the matching `.toml` at the repo root `commands/` (read by Gemini). Keep their `description` field aligned.
 
+Skills and agents live only at `plugins/cpln/skills/` and `plugins/cpln/agents/`. The `skills/` and `agents/` directories at the repo root are **generated mirrors for Gemini** — never edit them directly. The pre-commit hook in `.githooks/pre-commit` regenerates them whenever a source file is staged. Enable it once per clone:
+
+```bash
+git config core.hooksPath .githooks
+```
+
+If you ever need to refresh the mirrors manually, run `scripts/sync-gemini-content.sh`.
+
 For Markdown-only changes, review links, tables, frontmatter, and command examples manually. This repository currently has no package manifest, build script, or test suite.
 
 ## Versioning
@@ -97,6 +106,7 @@ Run before tagging:
 - `gemini-extension.json` MCP block uses Gemini CLI fields (`httpUrl`, `headers`) and declares any required extension settings.
 - `LICENSE`, `SECURITY.md`, `.env.example`, `.gitignore` are present.
 - `gemini extensions validate .` is clean.
+- `scripts/sync-gemini-content.sh --check` passes (root `skills/` and `agents/` match `plugins/cpln/`).
 - `claude plugin validate .` is clean (or only the deliberate developer-CLAUDE.md warning).
 
 ## Pull Requests