Skip to content

feat(skills): add html-artifact-builder (PlanViewer + ResultViewer)#6

Open
brolag wants to merge 3 commits into
mainfrom
feat/html-artifact-builder
Open

feat(skills): add html-artifact-builder (PlanViewer + ResultViewer)#6
brolag wants to merge 3 commits into
mainfrom
feat/html-artifact-builder

Conversation

@brolag

@brolag brolag commented Jun 27, 2026

Copy link
Copy Markdown
Owner

What

Adds html-artifact-builder: a single-file, framework-free HTML artifact generator for agentic workflows. One skill, two templates:

  • PlanViewer (pre-execution) — overview, phases & tasks, decisions, risks, and an open-questions decision queue with copy-back to the chat.
  • ResultViewer (post-execution) — summary, files changed, commands run, errors/warnings, and a next-steps checklist.

Why

Plans and run reports are easier to act on as a calm, scannable document than as a wall of chat text. The artifact lowers cognitive fatigue and surfaces what needs attention at a glance.

Highlights

  • Anti-cognitive-fatigue principles (documented in references/principles.md): progressive disclosure, chunking, status never by color alone (WCAG 1.4.1), sticky you-are-here nav, a Needs-Attention panel, reading-time.
  • Decision-grade stat-hero (effort / downtime / blast radius / blockers / risk), not vanity counts.
  • Decision queue + copy-back: a self-contained artifact can't message the agent, so answers export as markdown to paste back.
  • Automatic dark mode, reduced-motion guards, and a cross-platform literal font stack (var() in font-family proved unreliable).
  • Self-contained: no CDN, no build step, localStorage with in-memory fallback.

Notes

  • Auto-discovered via "skills": "./skills/" — no manifest changes needed.
  • Provider/OS-agnostic; no personal or stack-specific references.

brolag and others added 3 commits June 27, 2026 17:07
Single-file, framework-free HTML artifact generator for plans and results.

- PlanViewer (pre-execution): overview, phases/tasks, decisions, risks,
  and an open-questions decision queue with copy-back to the chat.
- ResultViewer (post-execution): summary, files changed, commands run,
  errors/warnings, and a next-steps checklist.

Anti-cognitive-fatigue UX: progressive disclosure, chunking, status never
by color alone, sticky you-are-here nav, a Needs-Attention panel, and a
reading-time estimate. Decision-grade stat-hero, automatic dark mode, and
reduced-motion guards. Cross-platform literal font stack (var() in
font-family proved unreliable). Self-contained: no CDN, no build step,
localStorage with in-memory fallback.
Invocation is now /html instead of /html-artifact-builder. Renames the
directory, frontmatter name, heading, and template header comments.
Aligns with the mind-forge canonical skill name.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
install.sh only copied SKILL.md per skill, which would leave html
broken (it ships templates/ and references/ it reads at runtime).
Copy the whole skill dir, add html to install/uninstall/test loops.

8 skills now (init, spec, craft, vet, exercise, git-save, slop-scan,
html). test-install.sh: 24/24 pass.

Note: collides with #5 (removes init -> 6); on merge, reconcile the
skill list/count to drop init, keeping html.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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