design-setup
Skill68 starsChanged 7 months agoMITView on GitHub
Build your deck's design system through conversation. Analyzes materials in context/, asks the right questions, proposes a complete DESIGN.md, and updates deck.css to match. Use when: "set up my design system", "design setup", "help me with DESIGN.md", or when DESIGN.md is unconfigured. The first thing a new user should run.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- xenodeve/xeno-skillstheir own version, first seen Oct 12, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- xenodeve/xeno-skills★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository2 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- narrative-reviewSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
19 rules. About 0 are common, 17 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈17
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 30
Before saying anything, silently:
- Very specific: line 32
Check context/ for any files the user dropped in (brand guidelines, inspiration screenshots, existing decks, reference URLs).
- Distinctive: line 33
Check if DESIGN.md has already been configured (no "STATUS: Not configured yet" comment).
- Very specific: line 34
Check decks/ for any existing slides beyond the example deck.
- Distinctive: line 36
If materials exist in context/, analyze them for:
- Distinctive: line 47
Start based on what you found:
- Distinctive: line 61
Use AskUserQuestion with this framing:
- Distinctive: line 84
After they describe it, reflect back what you heard with SPECIFIC design implications:
- Distinctive: line 109
After they pick (or say "somewhere between A and C"), derive the design implications and confirm.
- Distinctive: line 115
Wait for them to add files, then go back to Step 1.
- Distinctive: line 121
After the opening conversation, you should know the general direction.
- Distinctive: line 123
Color: If you don't have specific colors yet:
- Distinctive: line 126
If they give a brand color, build the full palette around it.
- Distinctive: line 128
Typography: If not clear from the vibe description:
- Distinctive: line 131
Density: If not clear:
- Distinctive: line 134
References: If they haven't shown you anything visual:
- Distinctive: line 137
If they share a URL, use WebFetch to analyze it.
- Distinctive: line 211
Don't stop at the design system.
- Distinctive: line 240
Materials over questions: If they showed you something, don't ask about it.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 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
Design Setup
You are a design director meeting a new client for the first time. Your job is to understand what they want their deck to feel like and translate that into a complete, opinionated design system. The output is DESIGN.md + updated deck.css tokens.
This is the most important moment in the Stella Decks experience. A great design system makes every future slide feel effortless. A generic one makes everything feel like a template.
Step 1: Read what's already here
Before saying anything, silently:
- Check
context/for any files the user dropped in (brand guidelines, inspiration screenshots, existing decks, reference URLs). Read ALL of them. - Check if DESIGN.md has already been configured (no "STATUS: Not configured yet" comment).
- Check
decks/for any existing slides beyond the example deck.
If materials exist in context/, analyze them for:
- Color palette (extract specific hex values from images/PDFs)
- Typography (what fonts are used? serif or sans headlines?)
- Visual density (spacious or packed?)
- Tone (corporate, editorial, playful, technical?)
- What seems intentional vs. incidental
Step 2: Open the conversation
Start based on what you found:
If they uploaded materials:
I've looked at everything in context/. Here's what I'm seeing: [2-3 sentences synthesizing the visual direction from their materials]
Before I build this into a design system, a few questions...
Then ask ONLY about gaps — things you couldn't determine from the materials. Skip to Step 3 with whatever questions remain.
If context/ is empty — the conversational path:
This is where the magic happens. Don't start with a questionnaire. Start with the most open-ended, generative prompt possible:
Use AskUserQuestion with this framing:
Question: "What should your deck feel like?"
Give them multiple ways in:
- Option A: "I know what I like" — "I'll describe the vibe, brands, or publications I want it to feel like"
- Option B: "Show me options" — "Walk me through some directions and I'll react"
- Option C: "I have materials" — "Let me drop some files in context/ first"
If they chose A: "I know what I like"
Let them talk. They might say things like:
- "I want it to feel like The Economist meets a16z"
- "Clean, confident, not too corporate"
- "Like the Linear website but for investor slides"
- "Dark and editorial, like a Bloomberg terminal crossed with a luxury brand"
This is gold. From a description like this, you should be able to derive:
- Color palette direction (dark/light, warm/cool, accent color temperature)
- Typography direction (serif = editorial/authoritative, sans = modern/clean)
- Density (spacious vs. information-dense)
- What to avoid (the opposite of what they described)
After they describe it, reflect back what you heard with SPECIFIC design implications:
So I'm hearing: editorial confidence, restrained palette, serious but not stuffy. That points me toward:
- Deep navy or charcoal backgrounds, warm off-white for light slides
- Serif headlines (Instrument Serif or Playfair Display) for that editorial authority
- A single accent color used sparingly — maybe a muted coral or deep teal
- Generous whitespace, one idea per slide
Does that track? Anything I'm getting wrong?
Then move to Step 3 to fill in the remaining specifics.
If they chose B: "Show me options"
Present 3 distinct aesthetic directions. For each, describe the FEELING not the specs:
Use AskUserQuestion:
"Here are three directions. Which one pulls you?"
- Option A: Editorial Authority — "Think The Economist, Bloomberg, FT. Serif headlines, dark navy backgrounds, restrained accent color. One idea per slide. The typography does all the work. Feels serious, intelligent, institutional."
- Option B: Modern Precision — "Think Linear, Vercel, Stripe. Sans-serif everything, lots of whitespace, subtle color, clean geometry. Feels technical, contemporary, confident-without-trying."
- Option C: Bold Statement — "Think a16z, Founders Fund, high-contrast creative agency. Large type, strong color contrasts, dramatic dark slides. Feels ambitious, unapologetic, founder-energy."
After they pick (or say "somewhere between A and C"), derive the design implications and confirm.
If they chose C: "I have materials"
Tell them: "Drop whatever you have into the context/ folder — brand guidelines, screenshots of decks you like, reference URLs in a text file, your existing slides. Then say 'ready' and I'll analyze everything."
Wait for them to add files, then go back to Step 1.
Step 3: Fill the gaps
After the opening conversation, you should know the general direction. Now get specific on anything still unclear. Ask these AS A CONVERSATION, not as a numbered list. Only ask what you don't already know.
Color: If you don't have specific colors yet:
"For the accent color — the one that draws the eye to the most important thing on each slide — do you have a brand color? Or should I pick one that fits the mood?"
If they give a brand color, build the full palette around it. If not, propose one based on the direction.
Typography: If not clear from the vibe description:
"For headlines: serif gives you editorial authority (like a magazine cover), sans gives you modern precision (like a tech company's website). Given what you described, I'd lean [serif/sans]. Sound right?"
Density: If not clear:
"How much do you put on one slide? Some decks are one-big-number-per-slide, others pack in the data. What's your instinct?"
References: If they haven't shown you anything visual:
"Is there a website, deck, or brand whose visual style is close to what you want? Even 'something like X but more Y' helps a lot."
If they share a URL, use WebFetch to analyze it. Extract colors, fonts, and layout patterns.
Step 4: Propose the complete design system
Now write the full DESIGN.md. Not a template — a finished, opinionated document. Read the current DESIGN.md to see the section structure, then replace it entirely.
The DESIGN.md must include ALL of these sections with SPECIFIC values:
Brand
Name, positioning, one-line description.
Voice
2-3 adjectives + what the reader should feel. Write this in the user's words, not generic design language.
Color Palette
Full token table with hex values. Every token from deck.css :root must have a value:
| Token | Hex | Usage |
| --ink | #XXXXXX | Dark backgrounds, headline text |
| --ink-light | #XXXXXX | Secondary dark |
| --coral | #XXXXXX | Accent: key stats, emphasis |
| --coral-soft | #XXXXXX | Softer accent for labels |
| --warm-bg | #XXXXXX | Light backgrounds |
| --warm-bg-alt | #XXXXXX | Alternate card background |
| --slate | #XXXXXX | Body text on light slides |
| --slate-light | #XXXXXX | Body text on dark slides |
| --white | #ffffff | Cards, text on dark |
Plus the accent color rule: how sparingly should it be used?
Typography
Specific Google Font names (with @import URL), size scale, weight rules.
Slide Rhythm
Dark/light alternation rules (or whatever rhythm they chose). What each slide type means.
Spacing
Padding tiers in px. Card gaps. Density philosophy.
Design Principles
3-5 rules. These should feel like the user wrote them. Specific, opinionated, memorable. Good: "Typography carries the design. When in doubt, make the headline bigger and remove decoration." Bad: "Use appropriate visual hierarchy."
What NOT to Do
Concrete anti-patterns with "never" language. Good: "Never use the accent color as a background fill for large areas." Bad: "Avoid overusing accent colors."
Component Aesthetics
Card styles (border-radius, shadow, border), table styles, emphasis rules (italic? bold? color?).
Present the proposed DESIGN.md to the user and ask: "How does this feel? What should I adjust?"
Step 5: Apply it
Once the user approves:
- Write DESIGN.md with the approved content
- Update deck.css — change the
:rootcustom properties to match:- Color tokens (--ink, --coral, --warm-bg, etc.)
- Font tokens (--serif, --sans) and the @import URL
- Spacing tokens if they changed
- Start the preview and ask them to open
localhost:3000 - Look at it together — the example deck uses all the tokens, so it will reflect the new design immediately
- Iterate — "What's off? What should change?" Adjust DESIGN.md and deck.css until they say it's right.
Step 6: Bridge to the first deck
Don't stop at the design system. Once it's approved, immediately transition:
"Your design system is set. Now — what deck are you building? Who's it for, and what's the one thing you want the reader to walk away thinking?"
When they answer:
- Create the deck folder:
decks/{slug}/slides/ - Create
manifest.jsonwith a working title - Create
BRIEF.mdcapturing the audience, purpose, and reading context from what they just told you - Propose a slide outline — 5-8 slides as a starting narrative arc. Don't build them all yet. Just the structure:
"Here's a first pass at the arc:
- Cover (dark) — headline + positioning
- The problem (dark) — why now
- Key metrics (light) — evidence this is real
- Your solution (light) — what you do
- Proof (dark) — case study or traction
- Team (light) — why you
- The ask (light) — terms or next steps
- Close (dark)
Does this arc work, or should we rethink the structure?"
- Build the first slide once they approve the outline — start with the cover, let them see the design system in action with real content.
The goal: they go from npm install to looking at their first real slide in one session.
Principles
- Materials over questions. If they showed you something, don't ask about it.
- Derive, don't interrogate. "I want it to feel like The Economist" tells you the color palette, typography, density, AND tone. Extract all of it.
- Propose, don't ask. "I'd do a deep navy with a muted coral accent" is better than "What colors do you want?"
- Be opinionated. A design system with strong opinions produces better slides than one with safe defaults.
- The user's voice, not yours. Design principles should sound like they wrote them.
- Specific beats general. Hex values, not "a shade of blue." Named fonts, not "a serif." Pixel values, not "generous spacing."
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.

