Files
pbakaus_impeccable/.github
Paul BakausandClaude Opus 4.6 473dbd52ef Trim SKILL.md plumbing; extract context + pin protocols to references
Before: 422 lines. After: 386 lines. The cut is conservative because
evals/AGENT.md revealed that most of what looked like bloat is actually
load-bearing: the font_selection_procedure with its 23-font ban list
(lesson 6), the theme_selection with audience examples (lesson 9), and
the absolute_bans with literal CSS patterns (lesson 7) all drive
measurable eval improvements and must stay inline.

What moved out of SKILL.md:
- Context Gathering Protocol (52 → ~18 lines). The full protocol — cache
  semantics, dispatch tree, teach/document/live exceptions, why-it-matters
  — moved to reference/context.md. SKILL.md keeps only the compact hook:
  load command, "never infer from codebase" warning, and pointer.
- Pin/Unpin (14 → 6 lines). Details moved to reference/pin.md.
- Spatial principles: dropped 4pt-vs-8pt rationale, gap-vs-margins CSS
  technicality, and container-queries-vs-viewport explanation (not
  load-bearing in the main skill). Kept all load-bearing rules
  including the 80-char body-text line (detector-backed).

What did NOT move (load-bearing per evals):
- <font_selection_procedure> with the 23-font ban list
- <theme_selection> with the 8 audience examples
- <absolute_bans> with literal CSS patterns
- All XML tag structure (lesson 8: XML works better than markdown
  for reasoning models, especially OpenAI)

Also added:
- reference/context.md (new) — full context protocol
- reference/pin.md (new) — full pin/unpin docs
- "Never infer brand, audience, or tone from the codebase" warning
  restored to SKILL.md (was dropped in an earlier refactor)

Fixed:
- reference/colorize.md had "Accent borders: Add colored left/top
  borders to cards or sections" which directly contradicted
  SKILL.md's absolute_ban on border-left/right > 1px. Rewrote the
  accent-border advice to use hairline borders, surface tints, or
  leading glyphs instead, with an explicit reference to the ban.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-14 10:02:19 -07:00
..