design-handoff

Name: design-handoff
Author: aj-geddes

github.com/aj-geddesDesign & UI374445 installsUpdated 34w ago

About design-handoff

A guide for design and development teams preparing implementation-ready handoffs. It focuses on clear specifications, assets, component states, responsive variants, and ongoing collaboration.

Key features

01Developer-oriented documentation
02Handoff checklist
03Component states and responsive variants
04Design-development collaboration
05Implementation review and iteration

Use cases

01Prepare designs before development begins
02Hand off a completed feature
03Communicate component library updates
04Coordinate design system changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill design-handoff

After installing, type/design-handoffin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/

design-dev-collaboration.md

developer-friendly-documentation.md

handoff-checklist.md

templates/

component-template.tsx

Details

From the project README

Overview

Design handoff bridges design and development, ensuring developers have all information needed to implement designs accurately and efficiently.

When to Use

Before development starts
Feature completion in design
Component library updates
Design system changes
Iterative refinement handoff

Quick Start

Minimal working example:

Design Handoff Package:

Overview:
  - Feature description
  - User flows
  - Key interactions
  - Platform (web, iOS, Android)

Screens & Components:
  - All screen designs
  - Responsive variants (mobile, tablet, desktop)
  - All component states (default, hover, focus, disabled, error)
  - Dark mode variants (if applicable)

Specifications:
  - Typography (font, size, weight, line-height)
  - Spacing & layout (padding, margin, gaps)
  - Colors (hex values, opacity)
  - Shadows & elevations
  - Border radius
  - Animations & transitions

Interactions:
  - Click/tap behaviors
  - Hover states
// ... (see reference guides for full implementation)

Reference Guides

Detailed implementations in the references/ directory:

Guide	Contents
Developer-Friendly Documentation	Developer-Friendly Documentation
Handoff Checklist	Handoff Checklist
Design-Dev Collaboration	Design-Dev Collaboration

Best Practices

✅ DO

Create comprehensive documentation
Export all assets and specifications
Document every component state
Include responsive variants
Explain design decisions
Provide developer-friendly specs
Use shared design tools
Schedule kickoff meeting
Make yourself available for questions
Review implementations and iterate

❌ DON'T

Expect developers to guess
Leave responsive design to chance
Skip edge case documentation
Use unclear specifications
Disappear after handoff
Change designs mid-development without notification
Provide images instead of vector files
Ignore technical constraints
Miss performance considerations
Skip accessibility in handoff

Comments

Markdown supported