ultimate-design-skill
v0.6.0
Published
Self-contained OKF design workflow for AI agents: DESIGN.md contracts, rendered UI checks, project-wide motion audits, critique/repair, and governed delivery.
Maintainers
Readme
Ultimate Design
A design workflow skill for AI agents.
It turns a design request into a usable result: clarify the brief, create a DESIGN.md when needed, load relevant design knowledge, make the artifact, critique and repair it, then verify what users will see.
Works with Codex, Claude Code, Pi Agent, and other compatible Agent Skill hosts.
Install
npx ultimate-design-skill@latest --target codex
npx ultimate-design-skill@latest --target claude-code
npx ultimate-design-skill@latest --target pi-agentSee integrations/README.md for project-scoped, shared, and manual installation.
Use
Use $ultimate-design to turn this report into a clear visual web page. Create DESIGN.md if needed, make the page, critique it, repair it, and verify the rendered result.Use --pro when you want to agree on the important design choices before implementation.
Portable Specialist mode (optional)
Default is single-agent. For multi-domain or high-risk work with independent decision clusters, the skill can use Portable Specialist mode: an Integrator routes concern-cluster work orders, specialists return packets only, and the Integrator remains the sole final writer of the artifact and DESIGN.md.
Use $ultimate-design in Portable Specialist mode for this public multi-domain landing page.
Keep Active OKF count-free. Route Narrative, Visual, and Interaction work orders on a file blackboard.
If the host cannot spawn workers, run the same protocol as serial role-passes.
Integrate, resolve conflicts, run co-constraint checks, then verify with validate_okf_usage.Details: skill/ultimate-design/references/multi-agent-mode.md and templates under skill/ultimate-design/templates/.
What It Covers
- Websites and marketing pages
- Product UI, dashboards, and flows
- HTML decks and presentation strategy
- Posters, social graphics, and print direction
- Brand systems, design audits, and content design
- Project-wide motion audits and evidence-backed repair
How It Works
- Keep the user's request anchored.
- Build a content and design contract.
- Load only the relevant OKF knowledge.
- Choose a direction and make the artifact.
- Critique, repair, and verify it.
- Leave enough context for the next Agent to continue.
Verification
Visual work should be rendered and reviewed before delivery. Use the host Agent's available browser, renderer, screenshot, and accessibility tools; record what was checked and any limits. The bundled HTML validators are optional deterministic tools for environments that provide their compatible runtime.
For development checks:
npm run flow-check
npm run okf-graph-check
npm run agent-handoff-check
npm run check-integrations