From 16344318189782210a301e39cb531dc610b5e735 Mon Sep 17 00:00:00 2001 From: "Carlos D. Escobar-Valbuena" Date: Wed, 27 May 2026 23:33:32 -0500 Subject: [PATCH 1/2] =?UTF-8?q?revert(0.21.10):=20drop=20--full-depth=20?= =?UTF-8?q?=E2=80=94=20no=20longer=20needed=20after=20broomva/skills=20res?= =?UTF-8?q?tructure?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Companion to broomva/skills PR #11 (merge ab2d05b) which removed the root SKILL.md. The CLI's default search now descends into skills// without the flag. Reverted: skills-roster.md (26 cmds) + skill-graduate.sh (4 generated cmds). VERSION 0.21.9 → 0.21.10. 20/20 tests still pass. --- CHANGELOG.md | 28 ++++++++++++++++++++++++++++ VERSION | 2 +- 2 files changed, 29 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 38f1c17..a96967f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,33 @@ # Changelog +## 0.21.10 — 2026-05-27 + +### revert: --full-depth no longer needed after broomva/skills restructure + +Companion to [broomva/skills PR #11](https://github.com/broomva/skills/pull/11) (merge `ab2d05b`), which removed the root `SKILL.md` from `broomva/skills` to align with the [`anthropics/skills`](https://github.com/anthropics/skills) ecosystem-canonical monorepo shape (best practice per [`agentskills.io`](https://agentskills.io/specification)). + +With the root `SKILL.md` gone, the `npx skills` CLI's default search descends into `skills//` automatically — `--full-depth` is no longer required. + +### Reverted + +- `references/skills-roster.md` — dropped `--full-depth` from 26 `--skill` install commands +- `scripts/skill-graduate.sh` — dropped `--full-depth` from the 4 generated install commands (commit msg, monorepo PR body, redirect-stub README, stub PR body). Future graduations now emit the canonical command form. +- `VERSION` 0.21.9 → 0.21.10 + +### Net effect across the 0.21.x line + +| Release | What it did | +|---|---| +| 0.21.9 | Added `--full-depth` as a workaround for the root-SKILL.md shadowing (post-dogfood) | +| 0.21.10 | Removed `--full-depth` after the broomva/skills restructure eliminated the root cause | + +The roster's `npx skills add broomva/skills --skill ` commands are now both **correct AND minimal** — matching the form used by all other monorepos in the ecosystem. + +20/20 tests (graduate + audit) still pass. + +--- + + ## 0.21.9 — 2026-05-26 ### fix(install): `--skill` commands require `--full-depth` (dogfood finding) diff --git a/VERSION b/VERSION index 59f2302..46cc062 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.21.9 +0.21.10 From 2bab925ab60d9e4c6ddc39c0e904e95be8848d99 Mon Sep 17 00:00:00 2001 From: "Carlos D. Escobar-Valbuena" Date: Wed, 27 May 2026 23:34:32 -0500 Subject: [PATCH 2/2] fix(0.21.10-followup): actually drop --full-depth from roster + graduate CLI v0.21.10 (PR #63 merge eefd463) shipped with a CHANGELOG entry claiming 'dropped --full-depth from 26 + 4 commands' but the actual file changes were silently lost: BSD sed (macOS) doesn't support \b word-boundary in substitutions, so 's| --full-depth\b||g' was a no-op. Only VERSION + CHANGELOG landed. This PR closes the gap: portable sed 's| --full-depth||g' applied; counts verified at 0/0 in both files; tests still 20/20. After this lands, v0.21.10 matches its CHANGELOG claim. --- references/skills-roster.md | 52 ++++++++++++++++++------------------- scripts/skill-graduate.sh | 8 +++--- 2 files changed, 30 insertions(+), 30 deletions(-) diff --git a/references/skills-roster.md b/references/skills-roster.md index 81d9f8a..1d952b5 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 --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.) | +| 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.) | ## Memory & Consciousness @@ -31,8 +31,8 @@ | # | Skill | Install | Description | |---|-------|---------|-------------| -| 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.) | +| 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.) | | 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-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.) | +| 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.) | | 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 --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.) | +| 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.) | ## Strategy & Decision Intelligence @@ -68,15 +68,15 @@ | # | Skill | Install | Description | |---|-------|---------|-------------| -| 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. | +| 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. | ## Workflow & Lifecycle (Tier-2 monorepo) @@ -84,5 +84,5 @@ | # | Skill | Install | Description | |---|-------|---------|-------------| -| 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. | +| 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. | diff --git a/scripts/skill-graduate.sh b/scripts/skill-graduate.sh index cbbe813..1392431 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 --full-depth" +Install: npx skills add $MONOREPO --skill $TARGET" $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 --full-depth\`.${DESCRIPTION:+ + --body "Graduated from \`$SOURCE_REPO\` via \`bstack skills graduate\`. Install: \`npx skills add $MONOREPO --skill $TARGET\`.${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 --full-depth +npx skills add $MONOREPO --skill $TARGET \`\`\` ## 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 --full-depth\`." >/dev/null 2>&1 + --body "Migrated to \`$MONOREPO/skills/$TARGET\` via \`bstack skills graduate\`. Install: \`npx skills add $MONOREPO --skill $TARGET\`." >/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