All products

Design handoff writing with AI

Specify interface measurements, states and behaviour for implementation

Design handoff writing with AI connects a picture of an interface to what developers need to build. The handoff-spec skill documents more than the default appearance: errors, loading, focus, long content and behaviour at different sizes belong in the handoff too.

The document can bring together spacing, typography, token names, motion, keyboard interaction and required assets. Details must come from the supplied design and agreed decisions. A thorough specification does not replace a developer walkthrough, test the finished implementation or grant permission to redistribute fonts and images.

What it does

  • Organise implementation specifications
  • Describe states beyond the default view
  • Use design token references consistently
  • Document interaction and keyboard behaviour
  • Explain content limits and localisation needs
  • List assets and implementation dependencies

Install and use

  1. Prepare the skill through the design-ops collection in Claude Code. Supply authorised designs and existing guidance with readable measurements, states and behaviours. The skill itself requires no separate design-service account.
  2. For example: “Write the handoff for this registration form, including errors, loading, keyboard order and long text.” State the component or flow in scope.
  3. Ask the agent to record values and token names from the source, keeping unknown behaviours open for a decision. Review minimum and maximum content and mobile differences.
  4. Walk through the document and asset list with the developer. Resolve permissions, dependencies and data assumptions; checking the completed build against the specification is a separate stage.

FAQ

Source

Made by MC Dean (Owl-Listener). Original skill: handoff-spec, published on GitHub under the MIT licence.

View on GitHub