cuellarfr/design-skills/design-ops

Claude Code and agent skill by cuellarfr/design-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Run design sprints, manage handoff, establish team rituals, documentation standards, and design QA processes. Covers the operational side of design — how teams organize work, collaborate with engineering, and ship quality.

Install

npx vskill@latest install cuellarfr/design-skills/design-ops

SKILL.md

Design Ops & Handoff

Operational processes that make design teams effective — sprints, handoff, rituals, documentation, and quality assurance.


Design Sprints

A 5-day process for solving big problems and testing ideas before committing engineering resources. Based on Jake Knapp's Sprint methodology developed at Google Ventures.

When to Sprint
SignalSprint Is RightSprint Is Wrong
Problem clarityBig problem, unclear solutionSolution already known — just build it
StakesHigh — wrong direction costs monthsLow — easy to course-correct later
Team alignmentDisagreement on approachTeam already aligned
Time pressureNeed answers this weekCan run a longer discovery process
ComplexityCross-functional problemSingle-discipline task
The 5-Day Structure
DayFocusKey ActivityOutput
MondayMapDefine the challenge, set a 2-year goal, map the problem space, pick a targetSprint questions, problem map, target area
TuesdaySketchReview existing solutions, each person sketches solutions individuallySolution sketches (one per person)
WednesdayDecidePresent sketches, vote (dot voting + decider picks), create storyboardStoryboard for prototype
ThursdayPrototypeBuild a realistic facade — just enough to testTestable prototype
FridayTest5 user interviews, observe together, identify patternsGo/no-go decision with evidence
Sprint Team
RoleCountResponsibility
Decider1Has authority to make final calls. Usually PM or founder
Facilitator1Runs the process, keeps time, manages energy
Designer1-2Leads sketching, builds prototype
Engineer1-2Feasibility gut-checks, helps prototype
Domain expert1-2Customer support, sales, marketing — whoever knows the user
Total5-7More than 7 is counterproductive
Sprint Rules
  1. No devices during working sessions — full attention
  2. Work alone together — individual sketching, not group brainstorming
  3. The Decider decides — democracy is slow; one person breaks ties
  4. Prototype, don't build — facade quality, not production quality
  5. 5 users is enough — you'll see 85% of usability issues with 5 participants

Design-to-Development Handoff

Handoff is the #1 source of quality loss in product teams. The goal: engineers should never have to guess.

Handoff Maturity Levels
LevelDescriptionSymptom
1. ScreenshotDesigner sends a static imageEngineers guess spacing, states, behavior
2. Annotated mockupRedlines, spacing calloutsBetter, but still missing states and edge cases
3. Interactive specFigma/design tool with inspect mode, component linksEngineers can extract values, but behavior is undocumented
4. Full specAll states, transitions, error handling, responsive behavior, tokensEngineers build exactly what was designed
5. IntegratedDesign and code share a component system; handoff is a conversation, not a documentMinimal spec needed — shared language does the work

Target: Level 4 minimum. Level 5 for mature teams.

What a Complete Handoff Includes

Every screen or component handoff must cover:

CategoryRequired Items
LayoutSpacing (in tokens, not pixels), alignment, responsive breakpoints, container behavior
ContentFinal copy (not lorem ipsum), character limits, truncation rules, localization notes
StatesDefault, hover, focus, active, disabled, loading, empty, error, success — for every interactive element
BehaviorWhat happens on click/tap, keyboard interaction, drag, swipe. Transition details
ResponsiveHow the layout adapts at each breakpoint. What reflows, stacks, hides, or changes
TokensColor tokens, typography tokens, spacing tokens — never raw hex/px values
AccessibilityFocus order, ARIA roles, screen reader announcements, touch targets, color contrast
Edge casesLong strings, empty data, error recovery, offline behavior, permissions
AssetsIcons (SVG), images (with alt text), animations (specs or files)
Handoff Anti-Patterns
Anti-PatternProblemFix
"It's in Figma"No context, engineer must reverse-engineer intentWrite behavior notes on every frame
Happy path onlyOnly the ideal flow is designedDesign all states before handoff
Pixel specs"24px left margin"Use tokens: spacing-md
Verbal handoff"I'll explain it in standup"If it's not written down, it doesn't exist
Big-bang handoffEntire feature dropped on engineering at onceHand off in slices that match sprint stories
No error states"We'll figure out errors later"Error states are designed first, not last

Team Rituals and Cadences

Core Design Rituals
RitualFrequencyDurationPurposeWho Attends
Design critiqueWeekly45-60 minImprove work-in-progress through structured feedbackAll designers
Design-eng syncWeekly30 minAlign on upcoming work, resolve handoff questionsDesign lead + eng lead
Design reviewPer milestone30-60 minStakeholder sign-off on directionPM, design, eng leads, stakeholders
Handoff sessionPer story/feature30-45 minWalk engineering through specs, answer questionsDesigner + implementing engineers
Design QAPer release60-90 minVerify implementation matches specDesigner + engineer
RetroBi-weekly or per sprint45 minImprove the processWhole product team
Design sprintAs needed5 daysSolve big problems, validate risky ideasCross-functional team (5-7)
Running Effective Design Critiques

Format: Presenter shares context (2 min) → Group reviews silently (3 min) → Structured feedback (15-20 min per piece) → Next steps (2 min)

Critique rules:

  1. Presenter states what feedback they want — "I need help with the empty state" not "What do you think?"
  2. Feedback references principles, not preferences — "This violates Fitts's Law" not "I don't like the button placement"
  3. Describe problems, don't prescribe solutions — "Users might miss this action" not "Make the button bigger"
  4. No defending — presenter listens, asks clarifying questions only
  5. Written notes — someone captures all feedback items with action owners
Handoff Session Structure
  1. Context (5 min) — What problem does this solve? What user story?
  2. Walkthrough (10-15 min) — Designer walks through the flow, screen by screen
  3. States and edge cases (10 min) — Hover, error, empty, loading, responsive
  4. Tokens and components (5 min) — Which design system components to use, which tokens
  5. Questions (10 min) — Engineers ask anything unclear
  6. Action items — What needs clarification before build starts

Documentation Standards

File Organization
project-name/
├── exploration/ # Early concepts, discarded directions
│ └── v1-concepts/
├── current/ # Active, approved designs
│ ├── flows/ # User flows and journey maps
│ ├── screens/ # Screen-level designs
│ └── components/ # Component-level specs
├── assets/ # Production-ready exports
│ ├── icons/
│ └── images/
├── handoff/ # Handoff documentation
│ └── [feature-name]/
└── archive/ # Past versions (never delete, move here)
Naming Conventions
ElementConventionExample
Files[project]-[feature]-[variant]taskpilot-onboarding-v2
Pages/frames[flow]-[step]-[state]checkout-payment-error
ComponentsMatch code component names exactlyButtonPrimary, not Main CTA
VersionsSemantic: v1.0, v1.1, v2.0Major = new direction, minor = iteration
LayersDescriptive, no "Group 1" or "Frame 47"header/nav/menu-trigger
Version Control Rules
  1. Never overwrite — create a new version, archive the old one
  2. Name the change — "v2.1 — added error states" not just "v2.1"
  3. Link to decisions — every major version links to the decision that drove it (Slack thread, meeting note, sprint review)
  4. Single source of truth — one canonical file per feature. No "copy of" files
  5. Archive, don't delete — move outdated designs to archive with a date stamp

Design QA

Design QA is the process of verifying that what was built matches what was designed. Do it before every release.

Design QA Checklist
CategoryCheckTool
Visual accuracyColors match tokens. Spacing matches spec. Typography is correctSide-by-side comparison, browser dev tools
StatesAll states render correctly: default, hover, focus, active, disabled, error, loading, emptyManual testing, Storybook
ResponsiveLayout works at all breakpoints. Nothing overflows, truncates wrong, or disappearsResize browser, test on real devices
ContentReal content fits. Long strings handled. Empty states designed. Truncation worksTest with edge-case content
InteractionAnimations match spec. Transitions are smooth. Timing feels rightManual testing, slow-motion recording
AccessibilityFocus order correct. Screen reader announces correctly. Contrast passes. Touch targets 44px+axe, keyboard testing, VoiceOver/NVDA
Cross-browserRenders correctly in Chrome, Firefox, Safari, EdgeBrowserStack or manual
PerformanceImages optimized. No layout shift. Animations don't drop framesLighthouse, Core Web Vitals
Filing Design QA Issues

Every issue needs:

**What:** [Element name] on [screen/page]
**Expected:** [What the design spec shows — link to frame]
**Actual:** [What the build shows — screenshot]
**Severity:** [Critical / Major / Minor / Cosmetic]
**Environment:** [Browser, viewport, OS]

Severity scale:

  • Critical — Functionality broken. User can't complete the task
  • Major — Wrong behavior. User can complete the task but with confusion or errors
  • Minor — Visual discrepancy. User isn't affected functionally but quality feels off
  • Cosmetic — Nitpick. Pixel-level differences that only designers notice
Acceptance Criteria for Design

Add these to every user story:

Design acceptance criteria:
- [ ] All states match design spec (link to Figma frame)
- [ ] Responsive behavior verified at 320px, 768px, 1024px, 1440px
- [ ] Keyboard navigation works (Tab, Enter, Escape, Arrow keys)
- [ ] Screen reader announces all interactive elements correctly
- [ ] Design tokens used (no hardcoded colors, spacing, or typography)
- [ ] Loading and error states implemented
- [ ] Edge-case content tested (empty, long strings, special characters)

Process Metrics

Track these to measure design ops health:

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 98 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
55
Repository forks
5
7-day trend score
20

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/cuellarfr/design-skills/design-ops/badge)](https://verified-skill.com/skills/cuellarfr/design-skills/design-ops)

Something wrong with this skill or its page? Tell us.