Skip to content

feat(cli-bundle): add Tech Leads Club agent-skills registry#12

Merged
govtech42 merged 4 commits into
mainfrom
claude/amazing-keller-EkQvk
May 29, 2026
Merged

feat(cli-bundle): add Tech Leads Club agent-skills registry#12
govtech42 merged 4 commits into
mainfrom
claude/amazing-keller-EkQvk

Conversation

@govtech42
Copy link
Copy Markdown
Owner

Summary

Wires the Tech Leads Club agent-skills registry into the cli-bundle plugin step (09-plugins.sh) as an opt-in, non-interactive install. The CLI supports install --skill … --agent … --global, so it installs cleanly headless across the CLIs that the harness bundles and the registry supports: claude-code, codex, cursor, opencode. Skills install globally (user home) so every project sees them.

Tuned for the MiranteGov and Municipium (MVP) stack confirmed by the user: Next.js + React Native/Expo, NestJS + Nx monorepo + Python, GovTech (public-facing → accessibility + security are requirements).

Curated default skill set (29)

a11y/quality: accessibility, web-quality-audit, react-best-practices, frontend-design, frontend-blueprint, react-composition-patterns
security: security-best-practices, security-threat-model, security-ownership-map
backend/arch: nestjs-modular-monolith, tactical-ddd, modular-design-principles, domain-analysis, coupling-analysis
mobile: react-native-expert
Nx monorepo: nx-workspace, nx-generate, nx-run-tasks, nx-ci-monitor
perf: core-web-vitals, perf-web-optimization
workflow/obs: gh-fix-ci, gh-address-comments, sentry, mermaid-studio, docs-writer
decision docs: create-adr, create-rfc, technical-design-doc-creator

All 29 names validated against the upstream catalog.

Changes

  • lib/plugins.sh — new install_agent_skills() helper: runs npx --yes @tech-leads-club/agent-skills install --global with repeated --skill/--agent flags; guards on npx presence and empty inputs.
  • profiles/cli-bundle/09-plugins.shINSTALL_AGENT_SKILLS block. Resolves the target agents to the intersection of installed CLIs and AGENT_SKILLS_AGENTS (skips agents that aren't installed; warns + skips if none match). Bakes in the curated default for AGENT_SKILLS_LIST.
  • profiles/cli-bundle/.env.exampleINSTALL_AGENT_SKILLS=false, AGENT_SKILLS_AGENTS, AGENT_SKILLS_LIST (empty = curated default).
  • README.md / profiles/cli-bundle/README.md — document the registry, the curated set, and how to override.

Verification

  • bash -n + shellcheck -S warning -e SC1090,SC1091 on the edited scripts — OK
  • tests/lint.sh and tests/check_env_completeness.sh — OK
  • Agent-resolution logic unit-tested across 6 toggle/request combinations (installed∩requested; empty when none installed)
  • 29 curated skill names cross-checked against the cloned upstream catalog

Notes / excluded by design

Skipped as out-of-scope or redundant: all (gtm)/* (sales/marketing); PaaS deploys (vercel/netlify/cloudflare/render) + aws-advisor (products run on own VPS); playwright-skill / chrome-devtools (harness already ships Playwright MCP + headless browser); shopify-developer, perf-astro (stack mismatch).

https://claude.ai/code/session_01CMLyxQST7SD4tSDvE1nF9T


Generated by Claude Code

claude added 4 commits May 29, 2026 13:44
Adds OpenViking (@openviking/cli, `ov`) as a sixth coexisting CLI in the
cli-bundle profile, following the npm-install pattern used by Codex.

- New 05c-openviking.sh: npm global install, INSTALL_OPENVIKING toggle,
  prints `ov config` setup hint (server defaults to http://localhost:1933)
- Wire into cli-bundle/install.sh after 05b-opencode
- Add INSTALL_OPENVIKING=false toggle + auth note to .env.example
- Document in README (profile table, CLI toggle table, repo layout)

Upstream: https://github.com/volcengine/OpenViking
Drops the GSD (Get Shit Done) and gstack plugins from the cli-bundle
plugin step. superpowers and OpenSpec remain, along with the official
Anthropic marketplace plugins.

- 09-plugins.sh: remove GSD and gstack install blocks; drop now-unused
  base-packages.sh source and ~/.bun/bin from PATH
- lib/plugins.sh: remove install_gstack_for(); tidy install_claude_plugin
  doc comment
- lib/base-packages.sh: remove install_bun() (only gstack consumed it)
- .env.example: drop INSTALL_GSD, INSTALL_GSTACK, GSTACK_TARGETS toggles
- README.md / cli-bundle/README.md: update plugin tables and lib helper lists
- .claude/TODO.md: drop GSD/gstack follow-ups
Wires the @tech-leads-club/agent-skills CLI into the plugins step as an
opt-in, non-interactive install across the CLIs that support it
(claude-code, codex, cursor, opencode). Skills install globally so every
project sees them.

Ships a curated default skill set tuned for the MiranteGov / Municipium
stack (Next.js + React Native, NestJS + Nx monorepo, GovTech accessibility
+ security): 29 skills spanning a11y, security review/threat-model, NestJS
modular monolith + tactical DDD, Nx tooling, React/frontend quality, perf,
Sentry, and ADR/RFC/TDD docs.

- lib/plugins.sh: install_agent_skills() helper (npx, --global, repeated
  --skill/--agent flags)
- 09-plugins.sh: INSTALL_AGENT_SKILLS block; resolves target agents to the
  intersection of installed CLIs and AGENT_SKILLS_AGENTS; baked-in curated
  default for AGENT_SKILLS_LIST
- .env.example: INSTALL_AGENT_SKILLS, AGENT_SKILLS_AGENTS, AGENT_SKILLS_LIST
- README.md / cli-bundle/README.md: document the registry and curated set

All 29 curated skill names validated against the upstream catalog.
@govtech42 govtech42 marked this pull request as ready for review May 29, 2026 14:58
@govtech42 govtech42 merged commit 55ecb5d into main May 29, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants