Tooluck logoTooluck
SKILL.md

gentle-design

Agent skill fromGentleman-Programming/gentle-shell

Trigger: design a screen or page, mockup, landing page, UI directions, artboards, try a different approach, design system sync. Write self-contained HTML design directions under design/<slug>/.

How to install gentle-design

install gentle-design
# install the gentle-shell pack with the skills CLI
npx skills add Gentleman-Programming/gentle-shell

# or add only this skill to Claude Code: copy the folder

skills/design/

# into

~/.claude/skills/design/ (all projects)

.claude/skills/design/ (one project)

skills/design/SKILL.md

MITFull file
1## Activation Contract
2
3Use this skill by default whenever the user asks, in plain words, for a UI design, mockup, screen, landing page, or visual directions, or iterates on artboards under `design/`. Do not use it to implement production code in the project's stack.
4
5The `/gentle:design` commands are optional shortcuts: every action also works from a plain request, through this skill and the `gentle_design` tool (`list`, `open`, `stop`, `implement`, `handoff`).
6
7## Hard Rules
8
9- Every artboard is one self-contained HTML file: inline CSS, JS, and SVG; system font stacks only. Never reference external URLs, CDNs, remote fonts, images, or scripts.
10- Use realistic content for the audience; no lorem ipsum or placeholder names.
11- Accessible markup: semantic elements and landmarks, WCAG AA contrast, visible focus styles, `prefers-reduced-motion` respected for any motion.
12- When `design/system.md` exists, read it first and use only its tokens and component rules; run the Self-check from "Design system sync" before finishing any artboard.
13- Ask at most one clarifying question, and only when the brief lacks the goal or the content.
14- Iterating edits only the targeted artboard. Never rewrite the others.
15
16## Decision Gates
17
18| Situation | Action |
19| --- | --- |
20| New brief | Write N clearly different directions (3 by default, or the number asked) to a new `design/<slug>/` |
21| Feedback on one artboard | Edit that file only; keep its manifest entry, update `tradeoff` if it changed |
22…

Excerpt shown under the repository's MIT license.

More skills in gentle-shell

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates