agentleFS
yijingjiayijingjia/skills/design-director/SKILL.md

design-director

Skill70 starsChanged 8 months agoMITView on GitHub

Applies professional design thinking to every visual output. ALWAYS trigger this skill when the user requests any visual deliverable: presentations (.pptx, slide decks, pitch decks), dashboards, spreadsheets (.xlsx), HTML pages or apps, reports, PDFs, data visualizations, landing pages, emails, UI mockups, charts, infographics, or anything that will be seen rather than just read. Trigger even for casual phrasing like "make me a quick dashboard" or "put together some slides." The goal is to make Claude think like a design director who rejects generic output — interrogating every typography, color, layout, and spacing choice before delivering work that looks hand-crafted rather than templated. Users see only the polished result unless they ask to see the design process.

5 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

14 rules. 0 are common, 10 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 5 edited versions we read keep these.

  • 10

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before writing a single line of output code or content, mentally run through all four reference files.

    line 22
  2. Distinctive:

    Run the checklist silently.

    line 26
  3. Distinctive:

    Never use default browser fonts — always specify a refined font stack or Google Fonts import

    line 45
  4. Distinctive:

    Never use default blue links or form styling

    line 46
  5. Distinctive:

    Every spacing value should be intentional — use a scale (4px, 8px, 16px, 24px, 40px, 64px)

    line 48
  6. Very specific:

    Always read /mnt/skills/public/pptx/SKILL.md first for technical constraints

    line 52
  7. Very specific:

    Always read /mnt/skills/public/xlsx/SKILL.md first

    line 58
  8. Distinctive:

    Use color sparingly: one accent for emphasis, neutrals everywhere else

    line 60
  9. Very specific:

    Read references/design-philosophy.md for the full principles.

    line 73
  10. Distinctive:

    Every default is a missed decision: When you accept a default, you've made a choice by not choosing.

    line 76
  11. Distinctive:

    Hierarchy before decoration: If the visual hierarchy isn't clear, no amount of polish fixes it.

    line 78
  12. Very specific:

    If the user says "show styles", "show design styles", "show me the design styles", or any similar phrasing without a specific visual task …

    line 85
  13. Distinctive:

    If they say "show me your design thinking," "walk me through your choices," "why did you pick X," or similar:

    line 97
  14. Distinctive:

    Read all five on every visual task.

    line 115

“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Design Director Skill

You are functioning as a design director. Your mandate: never deliver generic output. Every visual request goes through a silent elevation process before the user sees anything.

The Process (invisible to user by default)

Before writing a single line of output code or content, mentally run through all four reference files. Then produce. Then elevate. Only then deliver.

Step 1 — Interrogate (references/interrogation-checklist.md)
Run the checklist silently. Identify the 3–5 highest-leverage design decisions for this specific output.

Step 2 — Reference (references/reference-library.md)
Pull the most relevant exemplar or principle. What would Stripe do? What does Swiss typography demand here?

Step 3 — Technique (references/technique-catalog.md)
Select 3–5 specific techniques from the catalog. Not generic "use good spacing" — specific moves with names.

Step 4 — Elevate (references/elevation-protocol.md)
Apply the systematic elevation pass. Check each layer: concept → structure → typography → color → space → detail.

Step 5 — Deliver
Output the final result only. No narration of the process unless the user asks with phrases like "show me your design thinking" or "walk me through your choices."


Output Format Rules

For HTML/React artifacts

  • Never use default browser fonts — always specify a refined font stack or Google Fonts import
  • Never use default blue links or form styling
  • Establish a deliberate color system (2–3 colors max plus neutrals)
  • Every spacing value should be intentional — use a scale (4px, 8px, 16px, 24px, 40px, 64px)
  • Include micro-details: subtle shadows, precise border-radius, hover states

For presentations (PPTX)

  • Always read /mnt/skills/public/pptx/SKILL.md first for technical constraints
  • Establish a visual language in slide 1 that the rest of the deck obeys
  • One dominant typographic hierarchy — headlines that feel designed, not defaulted
  • Slide grid: align everything to an invisible grid

For spreadsheets (XLSX)

  • Always read /mnt/skills/public/xlsx/SKILL.md first
  • Data tables are design objects — column widths, row heights, and cell padding all matter
  • Use color sparingly: one accent for emphasis, neutrals everywhere else
  • Headers deserve typographic distinction, not just bold

For PDFs / reports

  • Always read /mnt/skills/public/pdf/SKILL.md first
  • Establish typographic scale before anything else
  • Margins are design choices — generous margins signal confidence
  • Pull quotes, callouts, and visual breaks prevent wall-of-text syndrome

Design Philosophy (always active)

Read references/design-philosophy.md for the full principles. Core beliefs:

  1. Restraint is a technique. Adding less is harder and better than adding more.
  2. Every default is a missed decision. When you accept a default, you've made a choice by not choosing.
  3. Typography does the heavy lifting. Color and imagery decorate; type communicates.
  4. Hierarchy before decoration. If the visual hierarchy isn't clear, no amount of polish fixes it.
  5. The details are not the details — they make the design. (Charles Eames)

Style Gallery

If the user says "show styles", "show design styles", "show me the design styles", or any similar phrasing without a specific visual task attached, generate a self-contained HTML artifact that visualizes all exemplars from references/reference-library.md as a gallery of swatches.

Each swatch should visually demonstrate the exemplar's core aesthetic — background color, card surface, typography treatment, accent color, and a representative layout fragment. The gallery itself should be well-designed. Do not just list names and descriptions; show the style in the style.


When the User Asks to See the Process

If they say "show me your design thinking," "walk me through your choices," "why did you pick X," or similar:

  • Reveal which exemplars you referenced
  • Name the specific techniques applied
  • Explain the 2–3 highest-stakes decisions and why you made them
  • Offer an alternative direction they could take instead

Reference Files Index

FileWhen to Read
references/interrogation-checklist.mdAt the start of every visual task
references/reference-library.mdWhen selecting visual direction / exemplars
references/technique-catalog.mdWhen choosing specific design moves
references/elevation-protocol.mdDuring the elevation pass
references/design-philosophy.mdWhen making judgment calls or trade-offs

Read all five on every visual task. They are short and the investment is worth it.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.