Skip to content

Add handoffs frontmatter to skill bundle recipes#36

Merged
nahiyankhan merged 1 commit intomainfrom
skill/recipe-handoffs
Apr 20, 2026
Merged

Add handoffs frontmatter to skill bundle recipes#36
nahiyankhan merged 1 commit intomainfrom
skill/recipe-handoffs

Conversation

@nahiyankhan
Copy link
Copy Markdown
Collaborator

@nahiyankhan nahiyankhan commented Apr 20, 2026

Summary

  • Each recipe (profile, review, verify, generate, compare, discover) now declares its common next actions as structured frontmatter — either another recipe via skill: or a CLI invocation via command:.
  • Pattern borrowed from DirectedEdges/specs' agent handoff convention, adapted for Ghost's skill bundle model.
  • Purely additive: the bundle loader copies files verbatim, so hosts that ignore unknown frontmatter keys see no change; hosts that read it can surface next-step actions inline.

Handoff graph

  • profilecompare (benchmark) or ghost emit review-command (set up drift detection)
  • reviewverify (regenerate to match) or ghost ack / ghost diverge / ghost adopt (record stance)
  • verifygenerate (regenerate with feedback) or profile (capture a missing decision)
  • generateverify (confirm the output stays in bounds)
  • compareghost ack / ghost adopt / ghost diverge
  • discoverprofile / compare

Notes

  • schema.md left alone — it's a reference, not a recipe.
  • No host harness currently parses the handoffs: key; it's documentation the host agent can read and act on. Wiring a parser would be a follow-up.

Test plan

  • pnpm check passes (pre-push hook)
  • pnpm build passes (pre-push hook)
  • pnpm test passes — 159 tests (pre-push hook)
  • Manually verify ghost emit skill <dir> copies the updated reference files with frontmatter intact

🤖 Generated with Claude Code

Each recipe (profile, review, verify, generate, compare, discover) now
declares its common next actions as structured frontmatter — either
another recipe via `skill:` or a CLI invocation via `command:`. Purely
additive: the bundle loader copies files verbatim, so hosts that ignore
unknown frontmatter keys see no change; hosts that read it can surface
next-step actions inline.

Pattern borrowed from DirectedEdges/specs' agent handoff convention.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@nahiyankhan nahiyankhan merged commit 944d61b into main Apr 20, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant