From e316da7389da6c28c55db7ec9653e52d8ce3b74f Mon Sep 17 00:00:00 2001 From: Fahmi Harun <34875577+kuker24@users.noreply.github.com> Date: Mon, 14 Sep 2026 18:22:56 +0700 Subject: [PATCH] docs: correct stocktake tally and normalize impeccable license string The stocktake table recorded adhd as KEEP even though its body was edited in the same pass to drop Claude Code and GrokBuild as runtime names. The evidence cell already described the edit, so the row and the tally disagreed with each other and with the CHANGELOG, which counted four host-name bodies while the tally showed three UPDATE. adhd moves to UPDATE (applied) with a writing-for-agents handoff. Recount from the table rows: 56 KEEP, 2 COMPRESS, 4 UPDATE, 0 MERGE, 0 RETIRE, total 62. impeccable frontmatter declared "Apache 2.0" while vendor/license-audit.json records "Apache-2.0". The test normalizes the form, so this was cosmetic, but the audit entry carried an evidence string of "SKILL.md frontmatter (Apache 2.0)" whose parenthetical only existed to flag the mismatch. Normalizing the frontmatter without it would have left the citation quoting a string no longer in the file, so both move together and the entry now matches its siblings. Closes follow-up 3 in docs/stocktake-1.8.3.md. Follow-ups 1, 2, and 4 stay open: the A/B baseline, the image_gen tool-family naming decision, and the 28 intentionally license-free frontmatters. No skill bodies changed apart from that one license string. VERSION stays 1.8.2, no 1.8.3 heading, no tag. --- CHANGELOG.md | 2 +- docs/stocktake-1.8.3.md | 8 ++++---- skills/impeccable/SKILL.md | 2 +- vendor/license-audit.json | 2 +- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 48181eb..dabac51 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,7 +10,7 @@ Catalog hygiene patch. No new skills, no new MCP, no foreign harness runtime. To - `tests/test_skills.py`: reconcile `vendor/skill-policy.json` against the actual `skills/`, `manual-skills/`, and `commands/` trees instead of trusting declared counts alone. Add frontmatter conformance (`name`, `description`, `compatibility: opencode`, `license`), model/manual name collision detection, a lexical description-overlap gate (warn at 50%, fail at 75% Jaccard), and a `~/.claude` runtime path assertion. Network-free and key-free. - `docs/warehouse-inventory.md`: `DEFER` no longer promotes to `NEW` without an existence pass and a no-skill baseline. Capability drift is grounds for `COMPRESS`/`RETIRE`, never a twin skill. Wave 1–3 counts are unchanged. - Document NVIDIA SkillEvaluator as `FOREIGN_ON_DEMAND`: never installed, absent is not a doctor failure, and a malformed MCP entry still fails closed. -- Execute the stocktake protocol across all 62 catalog items and record it in `docs/stocktake-1.8.3.md`: one verdict per item, 57 `KEEP`, 2 `COMPRESS`, 3 `UPDATE`, 0 `MERGE`, 0 `RETIRE`. `MERGE` is zero on measured evidence, the highest description overlap being 0.359 Jaccard, below the 50% warn line. No item is retired without a no-skill baseline; five candidates are recorded as blocked on the A/B gate. +- Execute the stocktake protocol across all 62 catalog items and record it in `docs/stocktake-1.8.3.md`: one verdict per item, 56 `KEEP`, 2 `COMPRESS`, 4 `UPDATE`, 0 `MERGE`, 0 `RETIRE`. `MERGE` is zero on measured evidence, the highest description overlap being 0.359 Jaccard, below the 50% warn line. No item is retired without a no-skill baseline; five candidates are recorded as blocked on the A/B gate. - `README.md`: document optional `stitch` MCP alongside `serena` and `exa`. Enabled only by `opencode-bf stitch enable`, keys referenced as `{env:STITCH_API_KEY}` or omitted with `--oauth`, not an owned core server and not a production UI implementer, absent is not a doctor failure. - Retire the predecessor `GrokBuild` host-product name from four skill bodies (`ask-matt` description, `chrome-devtools-axi` heading, `adhd`, `visual-studio`). `ask-matt` matters most: its description loads on every session. Tool-family references that name an image/video contract rather than the host are left intact. - `chrome-devtools-axi`: drop a `$HOME/.grok/bin` fallback that contradicted `rules/00-routing.md` ("Do not depend on `~/.grok` at runtime") and reconcile two duplicated invocation blocks. Port `9223`, the `HEADED`/`AUTO_CONNECT` prohibition, and the never-fall-back-to-Google-Chrome fence are unchanged. diff --git a/docs/stocktake-1.8.3.md b/docs/stocktake-1.8.3.md index 0a595e9..6fdbba8 100644 --- a/docs/stocktake-1.8.3.md +++ b/docs/stocktake-1.8.3.md @@ -13,7 +13,7 @@ License column is authoritative from `vendor/license-audit.json`, not frontmatte | Skill | Kind | Verdict | Evidence | Handoff | |---|---|---|---|---| | academic | model | KEEP | 45 lines, 5 refs; owns scholarly/IMRaD lane fenced off `research` and `smartdoc` | — | -| adhd | model | KEEP | Host-brand leak fixed this pass; remaining bulk is calibration numerics + upstream MIT attribution | — | +| adhd | model | UPDATE (applied) | Body named `Claude Code`/`GrokBuild` as if either were this runtime; remaining bulk is calibration numerics + upstream MIT attribution | `writing-for-agents` | | agent-architecture-audit | model | KEEP | 59 lines, NOTICE present; agent-loop lane distinct from `diagnosing-bugs` | — | | api-design | model | KEEP | 37 lines; REST contract lane fenced off `contract-first` | — | | ask-matt | model | UPDATE (applied) | Description said "GrokBuild skill or flow"; loaded every session | `writing-for-agents` | @@ -79,9 +79,9 @@ License column is authoritative from `vendor/license-audit.json`, not frontmatte | Verdict | Count | |---|---| -| KEEP | 57 | +| KEEP | 56 | | COMPRESS (applied) | 2 | -| UPDATE (applied) | 3 | +| UPDATE (applied) | 4 | | MERGE | 0 | | RETIRE | 0 | | **Total** | **62** | @@ -132,5 +132,5 @@ A baseline cannot be produced from inside a single session that already has the 1. Run the A/B gate on the five candidates above before proposing any RETIRE. 2. Decide whether the `GrokBuild image_gen` tool-family name should be renamed catalog-wide, or documented as the intended tool contract. -3. `impeccable` frontmatter declares `Apache 2.0` while `vendor/license-audit.json` records `Apache-2.0`; the test normalizes this, but aligning the string would remove the special case. +3. ~~`impeccable` frontmatter declares `Apache 2.0` while `vendor/license-audit.json` records `Apache-2.0`.~~ Resolved: frontmatter now reads `Apache-2.0`, and the audit evidence string dropped the parenthetical that only existed to flag the mismatch. 4. 28 of 62 skills omit a frontmatter `license` key by design. If that ever becomes confusing, document it in the skill authoring guide rather than adding keys. diff --git a/skills/impeccable/SKILL.md b/skills/impeccable/SKILL.md index 28795ba..b003898 100644 --- a/skills/impeccable/SKILL.md +++ b/skills/impeccable/SKILL.md @@ -2,7 +2,7 @@ name: impeccable description: Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks. Editorial HTML/SVG diagrams route to diagram-design. compatibility: opencode -license: "Apache 2.0" +license: "Apache-2.0" --- This skill gives you the tools and permission to create design that earns to be called out-of-distribution craft: Whereas before, your design work would have been safe, timid and measured, you now approach every design task as a award-winning design director with impeccable understanding for what makes exceptional design work: production-grade code, peak creativity, a clear POV, deep understanding of the needs of the client and users, and exceptional craft. diff --git a/vendor/license-audit.json b/vendor/license-audit.json index 51db18b..69479b1 100644 --- a/vendor/license-audit.json +++ b/vendor/license-audit.json @@ -11,7 +11,7 @@ }, "impeccable": { "license": "Apache-2.0", - "evidence": "SKILL.md frontmatter (Apache 2.0)", + "evidence": "SKILL.md frontmatter", "redistribution": "apache-2.0" }, "diagnosing-bugs": {