From bcfdd7da4a349f911f39623bb9f444f42c9566f6 Mon Sep 17 00:00:00 2001 From: Garry Tan Date: Fri, 14 Aug 2026 20:23:52 -0700 Subject: [PATCH] feat(gen): correct preamble tiers for the 8 silently-heaviest skills MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit With tiers now explicit, set them RIGHT by analogy to the tiered population: scrape/diagram/open-gstack-browser (+ the connect-chrome symlink) -> tier 1 (launchers and artifact generators, like browse and make-pdf); landing-report/pair-agent/skillify -> tier 2 (dashboards and session tools, like health and canary); spec -> tier 3 (interactive planning, like the plan-*-review family). Each tier-1 skill sheds 271 lines of onboarding prose it never needed; tier-2 shed 20 each. Verification per the review protocol: regen diff reviewed (pure section-removal), skill-validation + size-budget + catalog-budget + v0-dormancy suites green (822 tests), and live smoke of the tier-corrected skills confirms the preamble renders the intended sections at each tier. These skills have ~no eval coverage — stated honestly; the wave's gate-tier eval run is the backstop. Co-Authored-By: Claude Fable 5 --- diagram/SKILL.md | 271 +----------------------------- diagram/SKILL.md.tmpl | 2 +- landing-report/SKILL.md | 20 +-- landing-report/SKILL.md.tmpl | 2 +- open-gstack-browser/SKILL.md | 271 +----------------------------- open-gstack-browser/SKILL.md.tmpl | 2 +- pair-agent/SKILL.md | 20 +-- pair-agent/SKILL.md.tmpl | 2 +- scrape/SKILL.md | 271 +----------------------------- scrape/SKILL.md.tmpl | 2 +- skillify/SKILL.md | 20 +-- skillify/SKILL.md.tmpl | 2 +- spec/SKILL.md | 2 +- spec/SKILL.md.tmpl | 2 +- 14 files changed, 23 insertions(+), 866 deletions(-) diff --git a/diagram/SKILL.md b/diagram/SKILL.md index 63f848836..145434a1b 100644 --- a/diagram/SKILL.md +++ b/diagram/SKILL.md @@ -1,6 +1,6 @@ --- name: diagram -preamble-tier: 4 +preamble-tier: 1 version: 1.0.0 description: "Turn an English description (or mermaid source) into a diagram triplet: the source, an editable .excalidraw file you can open (gstack)" allowed-tools: @@ -330,131 +330,6 @@ AI orchestrator (e.g., OpenClaw). In spawned sessions: - Focus on completing the task and reporting results via prose output. - End with a completion report: what shipped, decisions made, anything uncertain. -## AskUserQuestion Format - -### Tool resolution (read first) - -"AskUserQuestion" can resolve to two tools at runtime: the **host MCP variant** (e.g. `mcp__conductor__AskUserQuestion` — appears in your tool list when the host registers it) or the **native** Claude Code tool. - -**Conductor rule (read before the MCP rule):** if `CONDUCTOR_SESSION: true` was echoed by the preamble, do NOT call AskUserQuestion at all — neither native nor any `mcp__*__AskUserQuestion` variant. Render EVERY decision brief as the **prose form** below and STOP. This is proactive, not a reaction to a failure: Conductor disables native AUQ and its MCP variant is flaky (it returns `[Tool result missing due to internal error]`), so prose is the reliable path. **Auto-decide preferences still apply first:** if a `[plan-tune auto-decide]