Skip to content

Claude Code skills for designers navigating codebases—component discovery, safe visual changes, design system exploration, and prototyping in real code.

Notifications You must be signed in to change notification settings

madebynoam/dcode

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dcode: Claude Skills for Designers

A toolkit for designers who work in code but don't live there.

dcode = design + code. These skills bridge the gap between "I have Figma" and "I need to ship this."

Most Claude Code skills assume you're a developer. These are different—they're designed for the designer's journey through a codebase: finding components, understanding design systems, making safe visual changes, and prototyping without fear.

Quick Start

# Find where a component lives
/dcode:find screenshot.png
/dcode:find "settings/profile"
/dcode:find "UserCard"

# Frame a feature around the user's job
/dcode:jtbd-frame "Referrals page"

# Rewrite UI copy through a JTBD lens
/dcode:jtbd-copy "Submit"
/dcode:jtbd-copy src/components/Form.tsx

# Improve UI copy with proven frameworks
/dcode:uxcopy "Submit"
/dcode:uxcopy -audit              # Interactive walkthrough
/dcode:uxcopy -list               # Show all frameworks

# Analyze session for reusable patterns
/dcode:mine

# End-of-session reflection
/dcode:reflect

Skills

dcode:find-component

Find UI components from screenshots, route paths, or component names.

The core designer superpower: "I see this button in the app... where's the code?" Give it a screenshot, and it finds the component. Works with React, Vue, Angular, and other component-based frameworks.

Input Output
Screenshot of a pricing card PricingCard component location, styles, related files
settings/profile Files for the profile settings page
DatePicker Component definition, usage examples, styles

Command: /dcode:find <target>

dcode:jtbd-prd-frame

Reframe features and PRDs around the user's job.

Takes a feature idea, PRD, or spec and asks: "What job is the user hiring this for?" Rewrites the definition so success is measured by the job, not the feature. Born from restructuring A4A's dashboard IA around Jobs to Be Done.

Input Output
"Referrals page" Job statement + reframed scope + placement rationale
PRD text Flagged feature-centric language + job-centric rewrites
"Where should this feature live?" Placement recommendation based on which job it serves

Command: /dcode:jtbd-frame [feature or PRD text]

dcode:jtbd-copy

Rewrite UI copy through a Jobs to Be Done lens.

Every label, placeholder, helper, and CTA rewritten to reflect the user's actual goal instead of the system's internal model. More focused than dcode:uxcopy -- specifically JTBD, not a multi-framework audit.

Element System-framed Job-framed
Header (none) "Send this to your client"
Field "Custom message" "Personal note"
Helper (none) "Builds trust and shows this comes from you"
CTA "Submit" "Send to client"

Command: /dcode:jtbd-copy [text or file]

dcode:improve-copy

Improve UI microcopy using proven UX writing frameworks.

Turn "Submit" into "Get started." Audit a component for bland buttons, vague errors, and empty states. Apply industry-standard frameworks:

Framework Turns this... Into this...
JTBD "Submit" "Get my results"
Benefit-first "Enable notifications" "Never miss updates"
Error patterns "Invalid input" "Email looks wrong. Try name@example.com"
Empty states "No results" "No projects yet. Create one to get started."
Loading states "Loading..." "Finding your files..."
Confirmation "Are you sure?" "This will delete all data. Continue?"
Voice & tone Formal ↔ casual, serious ↔ playful spectrums
4 C's checklist Clear, Concise, Conversational, Consistent

Interactive audit mode — Walk through each copy item with choices. Skip, apply, or hit r to apply your choice to all remaining items of the same type. Context-aware: auto-detects the file you're working on.

Mode Usage
Suggest /dcode:uxcopy "Submit" — Framework-based alternatives
Audit /dcode:uxcopy -audit — Interactive walkthrough
Batch /dcode:uxcopy -audit --batch — Table view, no prompts
Reference /dcode:uxcopy -list — Show all frameworks

Command: /dcode:uxcopy [text] [-audit] [-list] [--batch]

dcode:mine-patterns

Turn productive sessions into reusable skills.

At the end of a session, this skill analyzes what you did and suggests patterns worth automating. It's how these skills were born—and how you'll create your own.

Command: /dcode:mine

dcode:reflect-session

Capture learnings before they fade.

A guided reflection for the end of a work session. Surfaces what you learned (technical and soft skills), how you feel, and creates a searchable record of growth over time.

Command: /dcode:reflect [session-name]

Installation

Option 1: Copy to your Claude config

# Clone the repo
git clone https://github.com/madebynoam/dcode.git

# Copy skills
cp -r dcode/skills/* ~/.claude/skills/

# Copy commands
cp -r dcode/commands/* ~/.claude/commands/

Option 2: Reference directly

Just mention the skill by name in your prompt:

"Use dcode:find-component to find where this screenshot lives"

Repository Structure

dcode/
├── skills/
│   ├── find-component/SKILL.md     # Find components from visuals
│   ├── jtbd-prd-frame/SKILL.md     # Frame features around user jobs
│   ├── jtbd-copy/SKILL.md          # JTBD-focused UI copy
│   ├── improve-copy/SKILL.md       # Multi-framework UI microcopy
│   ├── mine-patterns/SKILL.md      # Surface reusable patterns
│   └── reflect-session/SKILL.md    # Capture learnings
├── commands/
│   ├── dcode:find.md               # /dcode:find shortcut
│   ├── dcode:jtbd-frame.md         # /dcode:jtbd-frame shortcut
│   ├── dcode:jtbd-copy.md          # /dcode:jtbd-copy shortcut
│   ├── dcode:uxcopy.md             # /dcode:uxcopy shortcut
│   ├── dcode:mine.md               # /dcode:mine shortcut
│   └── dcode:reflect.md            # /dcode:reflect shortcut
└── README.md

Philosophy

  1. Reduce fear, increase confidence — Codebases shouldn't be scary for designers
  2. Screenshot-first — Visual input is a designer's native language
  3. Progressive disclosure — Start simple, reveal complexity only when needed
  4. Learning loops — Reflection builds lasting skills, not just task completion

About

Created by Noam Almosnino, design lead at Automattic.

These skills grew out of real daily work—navigating a large React codebase, making design changes, and reflecting on what worked. They're functional prototypes: code-based artifacts that define agentic workflows.


"At the intersection of code and design"

About

Claude Code skills for designers navigating codebases—component discovery, safe visual changes, design system exploration, and prototyping in real code.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •