ds-design
Skill80 starsChanged 15 days agoMITView on GitHub
Builds a frontend with a clear visual direction instead of the generic AI look. Use when you create a new page, app screen, or component, or restyle one that looks templated. Run as /ds-design.
In this repository28 other files it gives its agents.
- ds-adoptSkill
- ds-best-of-nSkill
- ds-blast-radiusSkill
- ds-blueprintSkill
- ds-catchupSkill
- ds-context-resetSkill
- ds-design-auditSkill
- ds-explainSkill
- ds-helpSkill
- ds-jurySkill
- ds-ledgerSkill
- ds-lessonsSkill
- ds-modeSkill
- ds-plan-loopSkill
- ds-pr-commentsSkill
- ds-principlesSkill
- ds-prSkill
- ds-readySkill
- ds-review-loopSkill
- ds-reviveSkill
- ds-sharpenSkill
- ds-shipSkill
- ds-swarmSkill
- ds-tddSkill
- ds-unslopSkill
- ds-unstickSkill
- ds-verify-loopSkill
- ds-watch-prSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 15
Use a 4px or 8px spacing base, one or two radius values, and one shadow style or none.
- Distinctive: line 16
Ask: "Would I make this plan for any similar prompt?" Change each part where the answer is yes.
- Distinctive: line 18
Use motion only where it does a job.
- Distinctive: line 25
Use one of these only if the brief asks for it:
- Distinctive: line 41
All the states are built and the accessibility floor is met.
- Distinctive: line 46
When the brief specifies a font, color, or style, use it, even if it is on the banned list.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Build a UI that does not look like the default output for any similar prompt.
Steps
- Read the brief and the project. Find the subject, the audience, the one action you want the user to take, the stack, the existing brand, and the images you actually have. If the brief is vague, write down how you interpret it in one line and continue.
- Write a direction note of five lines or fewer before you write code. Include the purpose, the audience, the tone, the one memorable thing, and the mode (persuade, operate, or read). Take it from the subject's own world, not the usual look of its category.
- Define the tokens before you write components:
- Type: a display font and a body font that are clearly different. Do not use a default font for display. Use a 5-7 step scale, body text of 16px or more, and lines under 80 characters.
- Color: 4-6 named hex values. Use one dominant color for large areas and one sharp accent for actions only.
- Use a 4px or 8px spacing base, one or two radius values, and one shadow style or none.
- Ask: "Would I make this plan for any similar prompt?" Change each part where the answer is yes.
- Lay out the page with intent. Choose a density: airy for persuading, compact for tools. Use asymmetry or scale contrast where it serves the content. Use real copy and plausible data. Do not use lorem ipsum.
- Use motion only where it does a job. Use one orchestrated reveal, plus feedback on user actions.
- Build every state: hover, focus-visible, disabled, empty, loading, error, and long content.
- Meet the accessibility floor. Contrast must be 4.5:1, focus rings must be visible, and fields must have labels. Touch targets must be at least 44px, images need alt text, and reduced motion must be respected.
- Take screenshots at about 1440px and 390px wide. Check them against the banned defaults and the direction note. Fix the problems in one batch, then take new screenshots. Remove one decoration that does no work.
Banned defaults
Use one of these only if the brief asks for it:
- Purple-blue gradients and decorative gradient washes.
- Inter, Roboto, or the system font as the display face.
- Emoji used as icons. Use one set of SVG icons.
- A centered hero with three identical cards below it.
- Glassmorphism or glow on every surface.
- Gray text on a gray background with low contrast.
- Stock copy such as "Unlock your potential" or "Seamless".
- All-caps eyebrow labels above every heading.
- The same radius and soft shadow on every card.
Stop when
- The direction note and the tokens exist, and the code uses the tokens.
- The screenshots at both widths show no banned default and no horizontal scroll.
- All the states are built and the accessibility floor is met.
- The one memorable thing is visible in the screenshot.
Rules
- When the brief specifies a font, color, or style, use it, even if it is on the banned list.
- A refinement keeps the identity of the UI. A redesign keeps its content and function.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

