AGENTS.md · diff
git:20260811.a7125b1 to git:20260913.290ee1c
33 added, 0 removed. Audit A to A.
# CubeCloud Skills Bundle — Copilot Instructions
## Post-merge workflow
After merging from `origin/main` or installing any new skills batch:
1. Run `bin/full-audit.ps1` and report PASS / FAIL / WARN counts.
2. Verify active skill count in `~/.agents/skills/` against the README badge. If they diverge, flag it before claiming completion.
## Counter verification
After any skill install or removal, the README badge and SETUP_GUIDE counters must match reality. Check:
- `(Get-ChildItem ~/.agents/skills -Directory).Count` vs README badge
- `skills-list.csv` line count vs README claimed total
- If stale, update the counters inline before reporting "done."
+ ## `install-missing-skills.ps1 -WhatIf` does NOT prevent installs
+
+ Verified 2026-09-13. `-WhatIf` only gates the **refresh** path (via
+ `$PSCmdlet.ShouldProcess`). The **install** path calls `install-skill.ps1` as a child process
+ with no `-WhatIf` propagation, so it **really installs everything**.
+
+ Do not treat `-WhatIf` as a dry run. It is not safe to run for a preview. If you want a
+ preview, read `skills-list.csv` directly instead — the rows are the plan. To genuinely verify
+ without installing, check source-path existence for each row.
+
+ ## Two fork names are deliberately NOT the upstream repo name
+
+ `install-skill.ps1` clones `JZKK720/<last-path-segment>`. Two candidates collided with
+ unrelated pre-existing forks, so both were forked under a new name:
+
+ | Upstream | Naive name (already taken by) | Actual fork |
+ | --- | --- | --- |
+ | `tech-leads-club/agent-skills` | `agent-skills` (addyosmani/agent-skills — **this bundle's active mirror**) | `tech-leads-club-agent-skills` |
+ | `openai/skills` | `skills` (vercel-labs/skills) | `openai-skills` |
+
+ Never "simplify" these names. A naive clone of the tech-leads-club repo into `agent-skills`
+ would overwrite the addyosmani mirror that 23 manifest rows depend on.
+
+ ## Escaped-dollar in `git clone` lines is a silent failure
+
+ `setup-global-skills.ps1` had two clone lines written as `` `$"var`" `` (backtick-dollar = an
+ escaped literal `$`). Those interpolated nothing, so the clone command received a literal
+ `$<path>` argument and failed silently under `>nul 2>nul`. Effect: `archify` and `book-to-skill`
+ mirrors were never created by the installer. Fixed 2026-09-13.
+
+ When adding a clone line, confirm the variable is `"$var"` (no backtick) and that the
+ directory actually appears afterward — `>nul 2>nul` hides every error.
+
## Large install batches (10+ skills)
When installing 10+ skills in one session, start each batch in its own sub-process invocation so a single skill failure doesn't orphan the rest. If the batch exceeds ~20 skills, suggest a fresh chat or `/compact` to avoid context exhaustion mid-batch.