nexu-io/open-design

handoff

Push the run's accepted artifact to a downstream collaboration surface (cli, other code agents, cloud, desktop) and stamp the artifact manifest with the export target.

60Collecting
See how to use itView GitHub source
npx skills add https://github.com/nexu-io/open-design --skill "plugins/_official/atoms/handoff"
Automated source guideDevelopmentStandard source

Source checked Jul 28, 2026·Refresh due Oct 26, 2026

Reorganized from the pinned upstream SKILL.md

Source-grounded implementation guide: handoff

Spec §11.5.1 / §21.5: an OD run isn't done when the artifact exists — it's done when the artifact reaches the surface the user will keep iterating on. This atom is the "push it somewhere" stage. It's the natural counterpart to diff-review.

npx skills add https://github.com/nexu-io/open-design --skill "plugins/_official/atoms/handoff"
Check the pinned source

The pinned source supports a structured brief, but not an expanded tutorial. Only detected inputs, outputs, and sections are shown.

272 source words · 6 usable sections

Project context

  • The accepted artifact set (after diff-review resolved with
  • The export target (one of the surface enum values from
  • - The accepted artifact set (after diff-review resolved with decision: 'accept' | 'partial'). - The export target (one of the surface enum values from ArtifactManifest.exportTargets[].surface).

Code and changes

  • Updates ArtifactManifest.exportTargets[] with a row per push, appending — never replacing — so the artifact's distribution history stays append-only.

Implementation workflow

Read handoff through these 4 source sections

Sections are extracted automatically from the pinned SKILL.md and link back to the source.

01

Inputs

The accepted artifact set (after diff-review resolved with

SKILL.md · Inputs
The accepted artifact set (after diff-review resolved withThe export target (one of the surface enum values from- The accepted artifact set (after diff-review resolved with decision: 'accept' | 'partial'). - The export target (one of the surface enum values from ArtifactManifest.exportTargets[].surface).
02

Surfaces

Review the “Surfaces” section in the pinned source before continuing.

SKILL.md · Surfaces
Review and apply the “Surfaces” source section.
03

Output

Updates ArtifactManifest.exportTargets[] with a row per push, appending — never replacing — so the artifact's distribution history stays append-only.

SKILL.md · Output
Updates ArtifactManifest.exportTargets[] with a row per push, appending — never replacing — so the artifact's distribution history stays append-only.
04

Convergence

The atom completes when at least one exportTargets[] entry matches the user's intent or the user explicitly skipped via the confirmation GenUI surface.

SKILL.md · Convergence
The atom completes when at least one exportTargets[] entry matches the user's intent or the user explicitly skipped via the confirmation GenUI surface.

Development checklist

Verify each item before delivery

The source section “Inputs” has been checked.

The source section “Surfaces” has been checked.

The source section “Output” has been checked.

The source section “Convergence” has been checked.

Source output checked: Updates ArtifactManifest.exportTargets[] with a row per push, appending — never replacing — so the artifact's distribution history stays append-only.

Choose a different workflow

When another Skill is the better fit

FAQ

What does the handoff source document cover?

Spec §11.5.1 / §21.5: an OD run isn't done when the artifact exists — it's done when the artifact reaches the surface the user will keep iterating on. This atom is the "push it somewhere" stage. It's the natural counterpart to diff-review.

How do I install handoff?

The source record exposes this install command: npx skills add https://github.com/nexu-io/open-design --skill "plugins/_official/atoms/handoff". Inspect the command and pinned source before running it.

Repository stars
82,073
Repository forks
9,485
Quality
60/100
Source repository last pushed

Quality breakdown

Based on traceable docs and repository signals; stars are not treated as quality.

60/100
Documentation18/30
Specificity10/25
Maintenance20/20
Trust signals12/25

Compare before choosing

Related Agent Skills and source variants

These links are selected from shared tasks, functions, stacks, platforms, and same-name variants. Compare the source owner, documentation, permissions, and maintenance signals.

View original Skill.mdThis page is parsed directly from the repository SKILL.md without editorial rewriting. Collected: Jul 28, 2026 · about 2 min

Handoff

Spec §11.5.1 / §21.5: an OD run isn't done when the artifact exists — it's done when the artifact reaches the surface the user will keep iterating on. This atom is the "push it somewhere" stage. It's the natural counterpart to diff-review.

Inputs

  • The accepted artifact set (after diff-review resolved with decision: 'accept' | 'partial').
  • The export target (one of the surface enum values from ArtifactManifest.exportTargets[].surface).

Surfaces

surfacetypical follow-on
clithe user runs od files read against the project; no extra push
desktopopen the project in the OD desktop app
webpublish to the public marketplace via spec §13's od:// deep link
dockerwrap the artifact into a self-contained container (calls the §15.4 image)
githubopen a PR via od plugin publish --to <catalog>
figmaround-trip back into the figma-migration source file
code-agenthand off to Cursor / Claude Code / Codex sitting on top of the project cwd

Output

Updates ArtifactManifest.exportTargets[] with a row per push, appending — never replacing — so the artifact's distribution history stays append-only.

Convergence

The atom completes when at least one exportTargets[] entry matches the user's intent or the user explicitly skipped via the confirmation GenUI surface.

Anti-patterns the prompt fragment forbids

  • Pushing the artifact to a surface that wasn't on the user's intent list.
  • Mutating sourcePluginSnapshotId (it's immutable; the export trail is additive).
  • Treating figma as a no-op when the user's source was a Figma file — round-trip is the whole point of the figma-migration scenario.

Status

Implemented by the daemon runner in apps/daemon/src/plugins/atoms/handoff.ts. It records provenance, handoffKind, and export targets, then persists the updated artifact manifest.

Skill path
plugins/_official/atoms/handoff/SKILL.md
Commit SHA
89d6d4ef21ba
Repository license
Apache-2.0
Data collected