Design Ops logo

Design Ops

Community
cuellarfr
design-ops

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.

Overview

Publishercuellarfr
Repositorydesign-skills
Skill namedesign-ops
Stars
114
Forks
9
Bundled files
9
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 9 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by cuellarfr on GitHub. Read the source before you install it.

Installation

Install the Design Ops AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/cuellarfr/design-skills/tree/main/skills/design-ops
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/cuellarfr/design-skills.git /tmp/design-skills
mkdir -p .claude/skills
cp -r /tmp/design-skills/skills/design-ops .claude/skills/design-ops
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Design Ops in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Design Ops on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Design Ops is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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:

MetricWhat It MeasuresTargetHow to Measure
Handoff completeness% of handoffs with all states, tokens, responsive specs>90%Audit handoff docs quarterly
Design QA pass rate% of stories passing design QA on first review>80%Track QA issues per story
Rework rate% of design work that gets redone after handoff<15%Count post-handoff design changes
Sprint velocity impactHow often missing specs block engineering0 blocks/sprintTrack blocker tags in standup
Design debtKnown visual/interaction inconsistencies in productionDecreasing trendMaintain a design debt backlog
Critique participationDesigners bringing work to critique regularly100% monthlyTrack critique presenters

Scaled-Down Operations for Lean Teams

The processes above assume a dedicated design team. But many organizations have a single designer — or someone who does design as part of a broader role. The principles still apply; the execution scales down. This section provides adapted methods for resource-constrained teams, drawing on Leah Buley's UX team-of-one framework.

The Core Mindset

  1. Focus on small wins. You can't transform the organization overnight. Pick one visible improvement, deliver it, and let the result build momentum for the next
  2. Build a user-centered culture, not a UX department. Your goal isn't to own all design work — it's to make everyone on the team think about users
  3. Develop a growth mindset. Seek opportunities to expand skills incrementally. You don't need permission to start practicing research or testing

Guerrilla Methods

When you don't have budget, time, or formal research infrastructure:

Full ProcessGuerrilla AlternativeWhen It's Enough
Formal usability study (lab, recruiting, 5+ participants)Hallway testing with 3 people for 15 minutesEarly concepts, internal tools, low-stakes features
Multi-week discovery research3 customer interviews in one week + support ticket reviewYou need directional insight, not statistical confidence
Design sprint (5 full days)Mini-sprint: 2-day version (map + sketch on day 1, prototype + test on day 2)Smaller problems, aligned team, good prior research
Full journey mapping workshopAssumption map on a whiteboard (30 min with the team, mark what you know vs. guess)When you need alignment more than research
Formal design critique (weekly, all designers)Async critique in Figma comments with one engineer and one PMSolo designer, no design peers available
Design system with governanceComponent inventory + shared Figma library with naming conventionsSmall product, 1-3 engineers

Building Relationships and Advocacy

As a solo or lean-team designer, your effectiveness depends on relationships more than process.

Earn a seat at the table:

  • Start by meeting the team's immediate needs — even grunt work builds goodwill
  • Show, don't tell. A quick prototype that surfaces a problem is worth more than a presentation about UX maturity
  • Connect UX work to metrics leadership already cares about (conversion, support tickets, retention)

Influence without authority:

  • Frame recommendations as experiments, not mandates: "Can we test this with 3 users before committing?"
  • Share research findings in the format your audience consumes — Slack summary for engineers, dashboard for leadership, annotated screenshots for PMs
  • Present findings with confidence but invite collaboration: "Here's what we learned — what does this mean for your area?"

Adapted Rituals for Solo/Lean Teams

Full RitualLean AlternativeCadence
Weekly design critiqueBi-weekly "design lunch" — show WIP to anyone interested, even non-designersEvery 2 weeks
Design-eng sync15-minute standup addition: "Here's what's coming in design this sprint"Per sprint
Formal design reviewShare a 1-page decision doc with the PM before a milestone. Async approvalPer milestone
Design QA sprintQA checklist in the PR template — designer reviews before mergePer story
RetroAdd one design-specific question to the team retro: "Where did design and implementation diverge?"Per sprint

Scaled-Down Handoff

When full specs aren't practical:

  1. Annotate in-context. Add behavior notes directly on Figma frames — don't create a separate spec document
  2. Prioritize what's ambiguous. Don't spec obvious things. Focus on states, transitions, and edge cases that engineers would have to guess
  3. Walk through once, document questions. A 15-minute walkthrough call + a list of engineer questions answered in Figma comments is often enough
  4. Build shared vocabulary early. If you and the engineer agree on component names and token usage, you need fewer words in every handoff

The Power of Small Wins

Track and communicate your impact, even informally:

  • "We tested the new flow with 3 users — 2 couldn't find the save button. We moved it, and support tickets for that flow dropped 40%"
  • "The assumption map revealed we had no data on how users think about billing. Two interviews later, we redesigned the billing page before engineering started"
  • "Adding a design QA step to PRs caught 12 visual bugs this quarter that would have shipped"

Small wins compound. Each one makes the next conversation about investing in design easier.


Common Mistakes

MistakeWhy It FailsBetter Approach
Skipping the sprint map dayTeam builds solutions to the wrong problemMonday's map and target selection is the most valuable day
Designing in isolationWork handed off doesn't match engineering realityDaily or weekly design-eng syncs
No design QA processVisual quality degrades over timeQA every story, not just every release
Over-documenting30-page spec nobody readsSpec what's ambiguous. Shared component system handles the rest
Under-documenting"You can see it in Figma"If an engineer has to ask, the spec was incomplete
Treating handoff as a one-time eventThrows work over the wallHandoff is a conversation that continues through implementation
No retrosSame mistakes repeatBi-weekly retros with specific action items and owners
Design critique as approval gateCritique becomes politicalCritique is for improving work, not for approving it

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Design Ops AI skill do?

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.

Why use Design Ops on TypingMind?

Because you install it once and use it with any model. Design Ops is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Design Ops in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/cuellarfr/design-skills/tree/main/skills/design-ops. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Design Ops?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Design Ops?

As many as you like. As long as a model supports skills, you can use Design Ops with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Design Ops AI skill free?

Yes. It is published on GitHub by cuellarfr under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇