Skip to content

Add reveal.js, Figma canvas, interactive review, and web publishing#1

Draft
dallasbpeters wants to merge 3 commits intomainfrom
ux-audit-reveal-figma-publishing
Draft

Add reveal.js, Figma canvas, interactive review, and web publishing#1
dallasbpeters wants to merge 3 commits intomainfrom
ux-audit-reveal-figma-publishing

Conversation

@dallasbpeters
Copy link
Copy Markdown
Member

Summary

  • Two-session workflow: Session 1 (Discovery & Review) → design work → Session 2 (Client Report & Publish)
  • Three output formats: reveal.js slide deck (default), Figma canvas write, scrollable HTML
  • Interactive finding review (Phase 4): walk each finding with the team — confirm, reject, reprioritize before design work begins
  • Web publishing: publish-report.sh with Vercel/Netlify/Surge support, auth detection, 1Password guidance
  • Interactive shell scripts: run-audit-agent.sh and publish-report.sh prompt for all options when run without args
  • Figma MCP usage tracking: estimated call counts per phase, daily limit warnings by plan tier
  • Interactive embeds: click-to-activate / Esc-to-exit pattern for live app demos in presentations
  • Media support: inline screenshots, video walkthroughs, and iframe embeds in reveal.js slides

Files changed

  • SKILL.md — Major rewrite: 7 phases, two-session workflow, Figma usage limits, three output formats
  • AGENT.md — Updated tools, system prompt, session-aware invocation
  • references/figma-workflow.md — Rewritten for use_figma canvas API (replaces HTML capture)
  • references/report-template-reveal.html — Main template synced from demo, embed pattern, media CSS
  • references/report-template-reveal-demo.html — RapidAir demo with real content
  • scripts/run-audit-agent.sh — Interactive prompts with colored output
  • scripts/publish-report.sh — Interactive prompts, Vercel auth check, asset copying
  • New reference files: CSS, SVG logos, laws-of-ux, demo recording guide

Test plan

  • Run /ux-audit on NHCS project to validate full Session 1 flow
  • Verify interactive review (Phase 4) presents findings individually
  • Run /ux-audit report to generate reveal.js output
  • Test publish-report.sh interactive mode and Vercel deploy
  • Verify dark slide nav arrows visible on color system + recommendation slides
  • Test interactive embed click-to-activate and Esc-to-exit
  • Test PDF export via ?print-pdf

🤖 Generated with Claude Code

…ublishing to UX audit skill

Major restructure of the UX audit into a two-session workflow:
- Session 1 (Discovery): scan, token mapping, heuristic audit, interactive finding review
- Session 2 (Report): generate client deliverable with screenshots/video/embeds, publish

New output formats: reveal.js slide deck (default for client), Figma canvas write, scrollable HTML.
Interactive shell scripts with guided prompts for run-audit and publish.
Vercel/Netlify/Surge publishing with auth detection and 1Password guidance.
Figma MCP usage limit tracking and pre-flight warnings.
Embed pattern with click-to-activate/Esc-to-exit for live app demos in presentations.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
dallasbpeters and others added 2 commits March 25, 2026 09:48
When a project directory isn't found, the script searches common local
paths (~/Development, ~/projects, ~/code) and falls back to searching
RoleModel GitHub repos via `gh`. Offers to clone if found remotely.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…allation

Replaces the multi-step manual install process with ./scripts/setup.sh that
checks dependencies, symlinks the skill, verifies Figma MCP, and reports
what's missing. Simplifies README accordingly.

Co-Authored-By: Claude Opus 4.6 (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

Development

Successfully merging this pull request may close these issues.

1 participant