From 9a0ec4225d41863d8c001a184ae138cf16c8582c Mon Sep 17 00:00:00 2001 From: "Carlos D. Escobar-Valbuena" Date: Tue, 26 May 2026 21:48:23 -0500 Subject: [PATCH] fix(0.21.9): --skill install commands require --full-depth (dogfood finding) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit npx skills add broomva/skills --skill returns 'Found 1 skill' (root catalog only) — the CLI short-circuits subdir search at the root SKILL.md. Needs --full-depth to reach skills//. Fixed: skills-roster.md (26 cmds) + skill-graduate.sh (4 generated cmds, so future stubs are correct) + VERSION 0.21.8→0.21.9. 20/20 graduate+audit tests still pass. Verified: without flag 'Found 1 skill'; with it 'Found 53 skills'. --- CHANGELOG.md | 18 +++++++++++++ VERSION | 2 +- references/skills-roster.md | 52 ++++++++++++++++++------------------- scripts/skill-graduate.sh | 8 +++--- 4 files changed, 49 insertions(+), 31 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4b61d68..38f1c17 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,23 @@ # Changelog +## 0.21.9 — 2026-05-26 + +### fix(install): `--skill` commands require `--full-depth` (dogfood finding) + +`/dogfood` validation of the skills-monorepo install path found that `npx skills add broomva/skills --skill ` returns **"Found 1 skill"** (only the root catalog) — the `npx skills` CLI short-circuits subdirectory search once it finds a root `SKILL.md`. The monorepo's `skills//` subdirs are invisible without `--full-depth`. + +Empirically verified 2026-05-26: without flag → "Found 1 skill"; with `--full-depth` → "Found 53 skills" + handoff/pre-mortem install correctly (files on disk, content confirmed). + +**Fix:** +- `references/skills-roster.md` — all 26 `--skill` install commands now include `--full-depth` +- `scripts/skill-graduate.sh` — the 4 generated install commands (commit msg, monorepo PR body, redirect-stub README, stub PR body) now include `--full-depth`, so future graduations produce correct stubs +- `VERSION` 0.21.8 → 0.21.9 + +The command was asserted ~58× across the migration arc but never run until the dogfood. Classic P11: compile-time/spec-level correctness ≠ runtime correctness. + +--- + + ## 0.21.8 — 2026-05-26 ### `bstack skills audit` — skill registry audit (Phase 6c) diff --git a/VERSION b/VERSION index 4b9d187..59f2302 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.21.8 +0.21.9 diff --git a/references/skills-roster.md b/references/skills-roster.md index 1d952b5..81d9f8a 100644 --- a/references/skills-roster.md +++ b/references/skills-roster.md @@ -8,7 +8,7 @@ |---|-------|---------|-------------| | 1 | `agentic-control-kernel` | `npx skills add broomva/agentic-control-kernel` | LLM-as-controller with safety shields, typed plant/action/trace schemas, multi-rate loop hierarchy. The governance backbone. | | 2 | `control-metalayer-loop` | `npx skills add broomva/control-metalayer` | Control primitives: setpoints, sensors, actuators, stability gates, policy profiles. Bootstraps `.control/policy.yaml`. | -| 3 | `harness-engineering-playbook` | `npx skills add broomva/skills --skill harness-engineering-playbook` | Agent-first workflow: AGENTS.md, smoke/test/lint/typecheck harness, entropy-control checks. (Migrated 2026-05-25 from `broomva/harness-engineering-skill` — Phase 4c.) | +| 3 | `harness-engineering-playbook` | `npx skills add broomva/skills --skill harness-engineering-playbook --full-depth` | Agent-first workflow: AGENTS.md, smoke/test/lint/typecheck harness, entropy-control checks. (Migrated 2026-05-25 from `broomva/harness-engineering-skill` — Phase 4c.) | ## Memory & Consciousness @@ -31,8 +31,8 @@ | # | Skill | Install | Description | |---|-------|---------|-------------| -| 11 | `deep-dive-research-orchestrator` | `npx skills add broomva/skills --skill deep-dive-research-orchestrator` | Multi-dimensional research with coordinated AI specialists. 10+ source synthesis with citations. (Migrated 2026-05-25 from `broomva/deep-dive-research-skill` — Phase 4c.) | -| 11a | `social-intelligence` | `npx skills add broomva/skills --skill social-intelligence` | Autonomous social engagement + knowledge extraction loop for Moltbook and X — compounds with `blog-post` and `content-creation`. (Migrated 2026-05-25 from `broomva/social-intelligence` — Phase 4c.) | +| 11 | `deep-dive-research-orchestrator` | `npx skills add broomva/skills --skill deep-dive-research-orchestrator --full-depth` | Multi-dimensional research with coordinated AI specialists. 10+ source synthesis with citations. (Migrated 2026-05-25 from `broomva/deep-dive-research-skill` — Phase 4c.) | +| 11a | `social-intelligence` | `npx skills add broomva/skills --skill social-intelligence --full-depth` | Autonomous social engagement + knowledge extraction loop for Moltbook and X — compounds with `blog-post` and `content-creation`. (Migrated 2026-05-25 from `broomva/social-intelligence` — Phase 4c.) | | 12 | `skills` | `npx skills add broomva/skills` | Canonical reference inventory of 83 agent skills across 15 domains. Browsable catalog. | | 13 | `skills-showcase` | `npx skills add broomva/skills` | Remotion video + X thread generator for the skills inventory. Animated showcase content. | @@ -48,19 +48,19 @@ | # | Skill | Install | Description | |---|-------|---------|-------------| | 16 | `alkosto-wait-optimizer` | `npx skills add broomva/alkosto-wait-optimizer-skill` | Probability-based decision tool for optimal waiting times. Bayesian estimation with uncertainty. | -| 17 | `content-creation` | `npx skills add broomva/skills --skill content-creation` | Full-stack content pipeline — research → narrative → visual assets → video → social → deploy; ships bstack-launch + open-source-stack example campaigns. (Migrated 2026-05-25 from `broomva/content-creation` — Phase 4b.) | -| 17a | `content-engine` | `npx skills add broomva/skills --skill content-engine` | Full-stack AI content studio — visual DNA compiler, cinematic generation, browser autopilot, content loop; bundles 4 sub-skills. (Migrated 2026-05-25 from `broomva/content-engine` — Phase 4b.) | -| 17b | `launch-video` | `npx skills add broomva/skills --skill launch-video` | Liquid Glass product launch video — dark void, 3D floating panels, spring animations via Remotion. (Migrated 2026-05-25 from `broomva/launch-video` — Phase 4b.) | -| 17c | `ltx-video` | `npx skills add broomva/skills --skill ltx-video` | LTX-2.3 video generation — setup, inference, prompting, ComfyUI integration for Lightricks 22B DiT audio-video model. (Migrated 2026-05-25 from `broomva/ltx-video` — Phase 4b.) | -| 17d | `creative-review` | `npx skills add broomva/skills --skill creative-review` | Meta creative review — style adherence scoring, feedback loops, self-improving creative pipeline. (Migrated 2026-05-25 from `broomva/creative-review` — Phase 4b.) | -| 17e | `brainrot-for-good` | `npx skills add broomva/skills --skill brainrot-for-good` | High-retention video production using dopamine-aware editing for genuinely valuable content. (Migrated 2026-05-25 from `broomva/brainrot-for-good` — Phase 4b.) | +| 17 | `content-creation` | `npx skills add broomva/skills --skill content-creation --full-depth` | Full-stack content pipeline — research → narrative → visual assets → video → social → deploy; ships bstack-launch + open-source-stack example campaigns. (Migrated 2026-05-25 from `broomva/content-creation` — Phase 4b.) | +| 17a | `content-engine` | `npx skills add broomva/skills --skill content-engine --full-depth` | Full-stack AI content studio — visual DNA compiler, cinematic generation, browser autopilot, content loop; bundles 4 sub-skills. (Migrated 2026-05-25 from `broomva/content-engine` — Phase 4b.) | +| 17b | `launch-video` | `npx skills add broomva/skills --skill launch-video --full-depth` | Liquid Glass product launch video — dark void, 3D floating panels, spring animations via Remotion. (Migrated 2026-05-25 from `broomva/launch-video` — Phase 4b.) | +| 17c | `ltx-video` | `npx skills add broomva/skills --skill ltx-video --full-depth` | LTX-2.3 video generation — setup, inference, prompting, ComfyUI integration for Lightricks 22B DiT audio-video model. (Migrated 2026-05-25 from `broomva/ltx-video` — Phase 4b.) | +| 17d | `creative-review` | `npx skills add broomva/skills --skill creative-review --full-depth` | Meta creative review — style adherence scoring, feedback loops, self-improving creative pipeline. (Migrated 2026-05-25 from `broomva/creative-review` — Phase 4b.) | +| 17e | `brainrot-for-good` | `npx skills add broomva/skills --skill brainrot-for-good --full-depth` | High-retention video production using dopamine-aware editing for genuinely valuable content. (Migrated 2026-05-25 from `broomva/brainrot-for-good` — Phase 4b.) | | 18 | `finance-substrate` | `npx skills add broomva/finance-substrate` | Personal finance & Colombian tax management. Bank CSV import, TRM rates, DIAN tax projection, withholdings, e-invoicing. Zero paid deps. *(Pending Tier-1 vs Tier-2 lock-in.)* | -| 18a | `investment-management` | `npx skills add broomva/skills --skill investment-management` | Portfolio construction, factor models, backtesting, multi-platform execution (Alpaca, Coinbase, Polymarket). (Migrated 2026-05-25 from `broomva/investment-management` — Phase 4c.) | -| 18b | `wealth-management` | `npx skills add broomva/skills --skill wealth-management` | Wealth planning + Monte Carlo simulations + tax-optimized allocation + net worth forecasting. (Migrated 2026-05-25 from `broomva/wealth-management` — Phase 4c.) | -| 18c | `haima` | `npx skills add broomva/skills --skill haima` | Agent guide for x402 machine-to-machine payments, secp256k1 wallets, per-task billing, on-chain USDC settlement. (Migrated 2026-05-25 from `broomva/haima-skill` — Phase 4c; renamed to drop `-skill` suffix. Runtime crate stays at `broomva/haima`.) | -| 19 | `seo-llmeo` | `npx skills add broomva/skills --skill seo-llmeo` | SEO and LLM Engine Optimization — audits, meta tags, structured data (JSON-LD), llms.txt generation. (Migrated 2026-05-25 from `broomva/seo-llmeo` — Phase 4a.) | -| 20 | `brand-icons` | `npx skills add broomva/skills --skill brand-icons` | Brand icon and visual identity asset generation — favicons, app icons, OG images, social avatars. (Migrated 2026-05-25 from `broomva/brand-icons` — Phase 4a.) | -| 20b | `blog-post` | `npx skills add broomva/skills --skill blog-post` | Full-stack blog post production — research → angle → draft → multi-platform distribution (X, LinkedIn, Instagram, Substack). (Migrated 2026-05-25 from `broomva/blog-post` — Phase 4a.) | +| 18a | `investment-management` | `npx skills add broomva/skills --skill investment-management --full-depth` | Portfolio construction, factor models, backtesting, multi-platform execution (Alpaca, Coinbase, Polymarket). (Migrated 2026-05-25 from `broomva/investment-management` — Phase 4c.) | +| 18b | `wealth-management` | `npx skills add broomva/skills --skill wealth-management --full-depth` | Wealth planning + Monte Carlo simulations + tax-optimized allocation + net worth forecasting. (Migrated 2026-05-25 from `broomva/wealth-management` — Phase 4c.) | +| 18c | `haima` | `npx skills add broomva/skills --skill haima --full-depth` | Agent guide for x402 machine-to-machine payments, secp256k1 wallets, per-task billing, on-chain USDC settlement. (Migrated 2026-05-25 from `broomva/haima-skill` — Phase 4c; renamed to drop `-skill` suffix. Runtime crate stays at `broomva/haima`.) | +| 19 | `seo-llmeo` | `npx skills add broomva/skills --skill seo-llmeo --full-depth` | SEO and LLM Engine Optimization — audits, meta tags, structured data (JSON-LD), llms.txt generation. (Migrated 2026-05-25 from `broomva/seo-llmeo` — Phase 4a.) | +| 20 | `brand-icons` | `npx skills add broomva/skills --skill brand-icons --full-depth` | Brand icon and visual identity asset generation — favicons, app icons, OG images, social avatars. (Migrated 2026-05-25 from `broomva/brand-icons` — Phase 4a.) | +| 20b | `blog-post` | `npx skills add broomva/skills --skill blog-post --full-depth` | Full-stack blog post production — research → angle → draft → multi-platform distribution (X, LinkedIn, Instagram, Substack). (Migrated 2026-05-25 from `broomva/blog-post` — Phase 4a.) | ## Strategy & Decision Intelligence @@ -68,15 +68,15 @@ | # | Skill | Install | Description | |---|-------|---------|-------------| -| 21 | `pre-mortem` | `npx skills add broomva/skills --skill pre-mortem` | 4-category failure-mode analysis (likelihood × impact) with mitigation plan. | -| 22 | `premortem` | `npx skills add broomva/skills --skill premortem` | Klein/Kahneman premortem with parallel sub-agent deep-dives + HTML report. | -| 23 | `braindump` | `npx skills add broomva/skills --skill braindump` | Raw thoughts → Obsidian vault with auto-categorization, tags, and backlinks. | -| 24 | `morning-briefing` | `npx skills add broomva/skills --skill morning-briefing` | Daily focused brief from vault priorities + action items + updates. | -| 25 | `drift-check` | `npx skills add broomva/skills --skill drift-check` | Priority drift report — stated priorities vs actual effort (git log + vault). | -| 26 | `strategy-critique` | `npx skills add broomva/skills --skill strategy-critique` | Red-team critique of strategy documents with gaps, risks, missing assumptions. | -| 27 | `stakeholder-update` | `npx skills add broomva/skills --skill stakeholder-update` | One fact set → 3 audience versions (technical / business / customer). | -| 28 | `decision-log` | `npx skills add broomva/skills --skill decision-log` | Structured decision capture with context, alternatives, rationale → vault. | -| 29 | `weekly-review` | `npx skills add broomva/skills --skill weekly-review` | Weekly vault change scan + attention flags. | +| 21 | `pre-mortem` | `npx skills add broomva/skills --skill pre-mortem --full-depth` | 4-category failure-mode analysis (likelihood × impact) with mitigation plan. | +| 22 | `premortem` | `npx skills add broomva/skills --skill premortem --full-depth` | Klein/Kahneman premortem with parallel sub-agent deep-dives + HTML report. | +| 23 | `braindump` | `npx skills add broomva/skills --skill braindump --full-depth` | Raw thoughts → Obsidian vault with auto-categorization, tags, and backlinks. | +| 24 | `morning-briefing` | `npx skills add broomva/skills --skill morning-briefing --full-depth` | Daily focused brief from vault priorities + action items + updates. | +| 25 | `drift-check` | `npx skills add broomva/skills --skill drift-check --full-depth` | Priority drift report — stated priorities vs actual effort (git log + vault). | +| 26 | `strategy-critique` | `npx skills add broomva/skills --skill strategy-critique --full-depth` | Red-team critique of strategy documents with gaps, risks, missing assumptions. | +| 27 | `stakeholder-update` | `npx skills add broomva/skills --skill stakeholder-update --full-depth` | One fact set → 3 audience versions (technical / business / customer). | +| 28 | `decision-log` | `npx skills add broomva/skills --skill decision-log --full-depth` | Structured decision capture with context, alternatives, rationale → vault. | +| 29 | `weekly-review` | `npx skills add broomva/skills --skill weekly-review --full-depth` | Weekly vault change scan + attention flags. | ## Workflow & Lifecycle (Tier-2 monorepo) @@ -84,5 +84,5 @@ | # | Skill | Install | Description | |---|-------|---------|-------------| -| 30 | `handoff` | `npx skills add broomva/skills --skill handoff` | Fresh-session handoff doc drafting — compress an arc into a resumable doc for the next agent context. | -| 31 | `make-spec` | `npx skills add broomva/skills --skill make-spec` | Native-HTML design-doc scaffold (spec / plan / ADR / report / pr-explainer) using the canonical Broomva dark theme — implements P18 Category-C. | +| 30 | `handoff` | `npx skills add broomva/skills --skill handoff --full-depth` | Fresh-session handoff doc drafting — compress an arc into a resumable doc for the next agent context. | +| 31 | `make-spec` | `npx skills add broomva/skills --skill make-spec --full-depth` | Native-HTML design-doc scaffold (spec / plan / ADR / report / pr-explainer) using the canonical Broomva dark theme — implements P18 Category-C. | diff --git a/scripts/skill-graduate.sh b/scripts/skill-graduate.sh index 1392431..cbbe813 100755 --- a/scripts/skill-graduate.sh +++ b/scripts/skill-graduate.sh @@ -216,11 +216,11 @@ echo "==> committing + opening PR on $MONOREPO" $GIT commit -q -m "feat(monorepo): graduate $TARGET to Tier-2$RENAME_NOTE Migrated from $SOURCE_REPO via \`bstack skills graduate\`. -Install: npx skills add $MONOREPO --skill $TARGET" +Install: npx skills add $MONOREPO --skill $TARGET --full-depth" $GIT push -u origin "$BRANCH" >/dev/null 2>&1 $GH pr create --base main --head "$BRANCH" \ --title "feat(monorepo): graduate $TARGET to Tier-2$RENAME_NOTE" \ - --body "Graduated from \`$SOURCE_REPO\` via \`bstack skills graduate\`. Install: \`npx skills add $MONOREPO --skill $TARGET\`.${DESCRIPTION:+ + --body "Graduated from \`$SOURCE_REPO\` via \`bstack skills graduate\`. Install: \`npx skills add $MONOREPO --skill $TARGET --full-depth\`.${DESCRIPTION:+ $DESCRIPTION}" >/dev/null 2>&1 if [ "$DO_MERGE" = 1 ]; then @@ -248,7 +248,7 @@ if [ "$DO_STUB" = 1 ]; then ## New install command \`\`\`bash -npx skills add $MONOREPO --skill $TARGET +npx skills add $MONOREPO --skill $TARGET --full-depth \`\`\` ## Skill home @@ -267,7 +267,7 @@ Migrated to $MONOREPO/skills/$TARGET via \`bstack skills graduate\`." $GIT push -u origin chore/deprecate-redirect >/dev/null 2>&1 $GH pr create --base main --head chore/deprecate-redirect \ --title "chore(deprecate): redirect to $MONOREPO monorepo" \ - --body "Migrated to \`$MONOREPO/skills/$TARGET\` via \`bstack skills graduate\`. Install: \`npx skills add $MONOREPO --skill $TARGET\`." >/dev/null 2>&1 + --body "Migrated to \`$MONOREPO/skills/$TARGET\` via \`bstack skills graduate\`. Install: \`npx skills add $MONOREPO --skill $TARGET --full-depth\`." >/dev/null 2>&1 if [ "$DO_MERGE" = 1 ]; then if ! $GH pr merge chore/deprecate-redirect --squash --delete-branch >/dev/null 2>&1 \ && ! $GH pr merge chore/deprecate-redirect --squash >/dev/null 2>&1; then