design-craft
Agent skills for designed, not generated, frontends. UI/UX, design systems and motion for Claude Code and Codex.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/iitian001--design-craft)HTML
<a href="/listings/iitian001--design-craft"><img src="/api/listings/iitian001--design-craft/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**Claude Code and Codex, one command:**
git clone https://github.com/Iitian001/design-craft.git cd design-craft ./install.ps1 # Windows
git clone https://github.com/Iitian001/design-craft.git && cd design-craft && ./install.sh # macOS / Linux
The installer copies every skill in `skills/` to `~/.claude/skills/` and, if it exists, `~/.codex/skills/`. Re-run it after `git pull` to update.
**Manual:** copy `skills/design-craft` into `~/.claude/skills/` (Claude Code) or `~/.codex/skills/` (Codex).
**Use it:** type `/design-craft` in Claude Code, or `$design-craft` in Codex. Agents also pick it up automatically for UI, UX and motion work.
**Optional, for verification:** `pip install playwright` (it uses your installed Chrome or Edge).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 104 lines
- # Design Craft
- **Agent skills for building frontends that are designed, not just generated.**
- Works with **Claude Code** and **Codex**.
- `design-craft` is a working method an AI coding agent follows when it designs, builds, reviews or fixes
- UI: websites, landing pages, product screens, components, design systems, animation and scroll scenes.
- It's distilled from nine classic design books and sharpened by real builds, where every bug that slipped
- through became a rule.
- ```
- Frame → Find the signature → Explore cheaply → System first → Every state
- → Emotion, copy & honesty → Motion → Verify in a real browser → Hand off
- ```
- ## What it makes the agent do differently
- - **Frames the job before coding:** a job story, the ambition the brief actually asks for, and the
- visitor's emotional state on arrival.
- - **Finds a signature interaction in the subject** (a beer pours, a fabric drapes, a typeface flexes) and
- runs the *substitution test*: if the effect would work unchanged for any brand, it's not done.
- - **Builds tokens before components**, covers every state (focus, loading, empty, error, offline), and
- makes the newest async request win.
- - **Gives every animation a job**, with motion tokens, correct easing direction, interruption handling and a
- reduced-motion path. It also never makes people wait on choreography before they can act.
- - **Avoids engineering traps that broke real builds:** GSAP fighting CSS over a transform, scroll timelines
- that autoplay, snap labels past the timeline end, negative frame time, swappable assets that weren't preloaded.
- - **Verifies in a real browser** with an included Playwright walker: desktop, phone and reduced motion, a real
- pointer drag, console errors and sideways overflow.
- - **Stays honest:** labels AI imagery and demo data, makes copy match the images, and applies category rules
- (alcohol, finance, health).
- ## Install
- **Claude Code and Codex, one command:**
- ```powershell
- git clone https://github.com/Iitian001/design-craft.git
- cd design-craft
- ./install.ps1 # Windows
- ```
- ```bash
- git clone https://github.com/Iitian001/design-craft.git && cd design-craft && ./install.sh # macOS / Linux
- ```
- The installer copies every skill in `skills/` to `~/.claude/skills/` and, if it exists, `~/.codex/skills/`.
- Re-run it after `git pull` to update.
- **Manual:** copy `skills/design-craft` into `~/.claude/skills/` (Claude Code) or `~/.codex/skills/` (Codex).
- **Use it:** type `/design-craft` in Claude Code, or `$design-craft` in Codex. Agents also pick it up
- automatically for UI, UX and motion work.
- **Optional, for verification:** `pip install playwright` (it uses your installed Chrome or Edge).
- ## What's inside
- ```
- skills/design-craft/
- ├── SKILL.md the method: 8 steps, loaded every use (~2.5k tokens)
- ├── agents/openai.yaml Codex display metadata
- ├── references/ loaded only when a step needs depth
- │ ├── motion-engineering.md GSAP / ScrollTrigger / Lenis / canvas / gesture traps
- │ ├── verification.md what proves what, and environment traps
- │ ├── imagery.md generating and preparing images, product cut-outs
- │ ├── animation.md the 7 motion principles, tokens, easing, stagger maths
- │ ├── emotion.md persona, peak-end, trust, delight, error and outage copy
- │ ├── design-systems.md tokens, components, governance, versioning
- │ ├── product-design.md research, story-first, sketching, prototyping, testing
- │ ├── design-thinking.md empathise → define → ideate → prototype → test
- │ ├── design-engineering.md prototype fidelity, the design↔code handshake
- │ └── process-and-teams.md critique, rationale and handoff templates, DesignOps
- └── scripts/walk.py Playwright walker for real-browser verification
- evals/briefs/ benchmark briefs used to measure each version
- ```
- ## How it improves
- Every change has to earn its place:
- 1. Run a benchmark brief from `evals/briefs/` with the current skill.
- 2. Verify the result with `scripts/walk.py` and review it against the checklist in `SKILL.md` step 8.
- 3. Turn each real failure into **one** rule at the right level: a fix in the script first, then a reference
- file, and `SKILL.md` only if every task needs it.
- 4. Record what changed and why in `CHANGELOG.md`.
- See [CONTRIBUTING.md](CONTRIBUTING.md) and [ROADMAP.md](ROADMAP.md). Backend and system-design skills are next.
- ## Sources
- The principles are paraphrased and synthesised from these books. No text is reproduced beyond short
- phrases. The books are excellent and worth reading in full.
- - *Designing for Emotion*, Aarron Walter
- - *Animation Handbook*, *Design Engineering Handbook*, *Collaboration Handbook*, *Design Leadership Handbook*,
- *Design Thinking Handbook*, *DesignOps Handbook*, *Design Systems Handbook* (DesignBetter / InVision)
- - *Principles of Product Design* (InVision)
- This project is independent and not affiliated with or endorsed by the authors or publishers.
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.