design-handoff

Persists approved designs as ticket hierarchies or structured Markdown documents for future session recovery.

3|3|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/philipobenito/elelem --skill design-handoff-philipobenito
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-handoff
Source: https://github.com/philipobenito/elelem/tree/main/skills/design-handoff
Command: npx skills add https://github.com/philipobenito/elelem --skill design-handoff-philipobenito

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Approved designs often live only in conversation context and vanish when a session ends. This Skill persists an approved design into a durable artefact—a parent ticket carrying the full design with child tickets, or a structured Markdown document—so any future session can recover the design and resume work. ## Core Features & Use Cases - Multi-system persistence: Detects and creates tickets in GitHub Issues, Jira, GitLab, or Linear via MCP tools or CLI binaries, falling back to a structured Markdown document when no ticketing system is available. - Design-driven decomposition: Proposes ticket breakdowns read from the design's own structure, with dependency ordering, acceptance criteria, and an approval gate before anything is created. - Failure-safe creation: Creates the parent first, then children in dependency order, with explicit handling for partial failures and no destructive rollback. - Use Case: After approving an architecture design for a new feature, ask to file it as tickets; the Skill detects GitHub from the git remote, drafts an Epic-style parent with the full design plus child tickets, and creates them only after your approval. ## Quick Start Ask the AI to break the approved design into tickets and file them in the detected issue tracker.

Frequently Asked Questions about design-handoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn an approved design into tickets?

Invoke the skill with an approved design in context; it detects the available ticketing system, proposes a decomposition with dependencies and acceptance criteria, and creates the tickets only after you approve the full set at the gate.

Which issue trackers does design ticket creation support?

GitHub Issues, Jira, GitLab, and Linear are supported, detected via MCP tools, the git remote URL, or CLI binaries like gh and glab. When none is available, the design is written as a structured Markdown document instead.

What happens if there is no ticketing system available?

The skill writes a structured Markdown document to the project root or a chosen location. The document acts as the parent, carrying the full design under a Design section and each ticket as a heading with dependencies and acceptance criteria.

Can I create tickets without an approved design?

No. The skill requires an explicitly approved design in context and stops if none exists, rather than inventing one. It also does not start a design session on the user's behalf.

What happens when ticket creation fails partway through?

Creation stops immediately, the parent is back-filled with the children that were created, and the failed ticket and its intended position are reported. Created tickets are never rolled back; whether to retry or keep the partial state is the user's decision.

Why does the parent ticket contain the full design instead of a link?

Links rot and external context disappears, so the parent body embeds the complete design as the single source of truth. Child tickets carry only their own scope, avoiding duplicate design copies that drift out of sync.