Skip to content

feat: /design-html skill — Pretext-native HTML from approved mockups (v0.14.0.0)#653

Merged
garrytan merged 7 commits intomainfrom
garrytan/design-html-skill
Mar 30, 2026
Merged

feat: /design-html skill — Pretext-native HTML from approved mockups (v0.14.0.0)#653
garrytan merged 7 commits intomainfrom
garrytan/design-html-skill

Conversation

@garrytan
Copy link
Copy Markdown
Owner

Summary

New skill: /design-html — takes an approved design mockup from /design-shotgun and generates production-quality Pretext-native HTML. Text reflows on resize, heights adjust to content, layouts are dynamic. The first AI design tool where text actually works correctly.

Core feature:

  • design-html/SKILL.md.tmpl — new skill template with Pretext API cheatsheet, smart routing per design type, refinement loop, framework detection, live reload, verification screenshots
  • design-html/vendor/pretext.js — vendored 30KB Pretext source for zero-dependency HTML output

Pipeline integration:

  • design-shotgun Step 6 option B now chains to /design-html
  • design-consultation suggests /design-html after producing screen-level designs
  • plan-design-review next steps expanded to include /design-shotgun and /design-html alongside review skills

Test fix:

  • Updated test/gen-skill-docs.test.ts assertion for expanded chaining
  • Added (gstack) keyword to design-html description for validation compliance

Test Coverage

All new code paths are SKILL.md template content (prompt engineering, not application code). Validated by:

  • skill-validation.test.ts — auto-detects new skill, validates frontmatter, description, tools
  • gen-skill-docs.test.ts — validates generation, freshness, chaining, description keywords

Tests: 653 pass, 0 fail across 2 test files.

Pre-Landing Review

This is a prompt template (SKILL.md.tmpl), not application code. No SQL, no auth boundaries, no LLM trust violations. The vendored pretext.js is a 5-line CDN redirect (actual Pretext loaded at runtime in generated HTML).

Pre-Landing Review: No structural issues found.

Plan Completion

Plan file: ~/.claude/plans/fuzzy-forging-kite.md

  • [DONE] Create design-html/SKILL.md.tmpl — primary deliverable
  • [DONE] Create design-html/vendor/pretext.js — vendored Pretext source
  • [DONE] Update design-shotgun/SKILL.md.tmpl Step 6 to chain to /design-html
  • [DONE] Update design-consultation/SKILL.md.tmpl to suggest /design-html
  • [DONE] Update plan-design-review/SKILL.md.tmpl to chain to design skills
  • [DONE] Regenerate all SKILL.md files

Completion: 6/6 DONE.

Review Dashboard

Review Status
CEO Review CLEAR (SCOPE EXPANSION, 6 accepted)
Eng Review CLEAR (PLAN)
Outside Voice Codex ran, 7/9 findings incorporated

Test plan

  • bun test — 653 pass, 0 fail
  • bun run gen:skill-docs — all SKILL.md files fresh
  • Version sequence contiguous in CHANGELOG.md

🤖 Generated with Claude Code

garrytan and others added 7 commits March 29, 2026 22:54
New skill that takes approved design-shotgun mockups and generates
production-quality HTML with Pretext for computed text layout. Text
reflows on resize, heights adjust to content, zero hardcoded CSS.

Includes vendored Pretext bundle (30KB), smart API routing per design
type, AskUserQuestion refinement loop, framework detection, and
3-viewport verification screenshots.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- design-shotgun: Step 6 option B now chains to /design-html
- design-consultation: suggests /design-html after shipping DESIGN.md
  (conditional on screen-level output, not tokens-only)
- plan-design-review: expanded chaining to include /design-shotgun
  and /design-html alongside review skills

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
plan-design-review now chains to /design-shotgun and /design-html
in addition to review skills. Update the assertion to match.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Main landed v0.13.10.0 (Office Hours reading list) while this branch
had v0.14.0.0. Kept v0.14.0.0 (higher, new feature) and preserved
both CHANGELOG entries in correct order. Updated package.json to match.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

E2E Evals: ✅ PASS

7/7 tests passed | $.82 total cost | 12 parallel runners

Suite Result Status Cost
e2e-design 3/3 $0.58
e2e-plan 1/1 $0.1
llm-judge 2/2 $0.04
e2e-plan 1/1 $0.1

12x ubicloud-standard-2 (Docker: pre-baked toolchain + deps) | wall clock ≈ slowest suite

@garrytan garrytan merged commit 8151fcd into main Mar 30, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant