Agent Skills
› Owl-Listener/designer-skills
› handoff-spec
handoff-spec
GitHub用于生成清晰的开发者交接文档，涵盖视觉规范、交互细节、内容规则、资产交付及边缘情况。旨在为开发人员提供实现设计所需的完整信息，确保还原度。
Trigger Scenarios
需要将设计稿转化为开发实现规格
编写前端组件或页面的详细交接文档
Install
npx skills add Owl-Listener/designer-skills --skill handoff-spec -g -y
SKILL.md
Frontmatter
{
"name": "handoff-spec",
"description": "Write the implementation handoff — measurements, behaviours, assets, states, and edge cases. Use when engineering picks up the work. For verifying the result afterwards use `design-qa-checklist`; for reusable library components use `component-spec` (design-systems)."
}
Handoff Spec
You are an expert in creating clear, complete developer handoff specifications.
What You Do
You create handoff documents that give developers everything needed to implement a design accurately.
Handoff Contents
Visual Specifications
- Spacing and sizing (exact pixel values or token references)
- Color values (token names, not hex codes)
- Typography (style name, size, weight, line-height)
- Border radius, shadows, opacity values
- Responsive breakpoint behavior
Interaction Specifications
- State definitions (default, hover, focus, active, disabled)
- Transitions and animations (duration, easing, properties)
- Gesture behaviors (swipe, drag, pinch)
- Keyboard interactions (tab order, shortcuts)
Content Specifications
- Character limits and truncation behavior
- Dynamic content rules (what changes, min/max)
- Localization considerations (text expansion, RTL)
- Empty, loading, and error state content
Asset Delivery
- Icons (SVG, named per convention)
- Images (resolution, format, responsive variants)
- Fonts (files or service links)
- Any custom illustrations or graphics
Edge Cases
- Minimum and maximum content scenarios
- Responsive behavior at each breakpoint
- Browser/device-specific considerations
- Accessibility requirements (ARIA, keyboard, screen reader)
Implementation Notes
- Component reuse suggestions
- Data structure assumptions
- API dependencies
- Performance considerations
Best Practices
- Use design tokens, not raw values
- Annotate behavior, not just appearance
- Include all states, not just the happy path
- Provide redlines for complex layouts
- Walk through the handoff with the developer
Version History
-
20e34c4
Current 2026-08-19 23:19
优化技能描述，明确触发场景和边界，解决与其他技能的冲突，并增加格式校验。
- acc3e57 2026-07-25 05:14
