Agent skill

spec-handoff

Prepare structured spec handoff state for paused, blocked, resumed, or transferred feature work. Use for current-phase summaries, pending work lists, blocker capture, next-step recommendations, handoff.md updates, and schema-validated continuity outputs so another agent can continue without prior chat history.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/shaowei-g/codex-skills/tree/main/skills/spec-orchestrator/spec-handoff

SKILL.md

Spec Handoff

Use this skill when handoff or continuity packaging is the current phase for one feature.

Shared Contracts

Load this shared shortcut first:

  • ../references/shared-specialist-contract.md

Open the deeper canonical shared references only when the shortcut is insufficient for the current situation.

Helper Scripts

  • workflow executor: ./scripts/prepare_handoff.sh
  • handoff markdown renderer: ./scripts/render_handoff_template.sh
  • fixed response formatter: ./scripts/print_handoff_response_schema.sh
  • helper validator: ./scripts/validate_handoff_response.sh

These scripts can assist with deriving handoff state and rendering handoff.md, but the orchestrator still treats the shared response schema and shared validator as the final transport contract.

Purpose

Use this skill for:

  • ending a bounded orchestration pass
  • pausing partially completed work
  • summarizing blockers before stopping
  • preparing resumption context for another agent
  • packaging continuity state so the next agent can continue without chat history

Read Order

  • specs/<feature>/handoff.md if present
  • specs/<feature>/spec.md if present and its marker state
  • specs/<feature>/plan.md if present and its marker state
  • specs/<feature>/tasks.md if present and its marker state
  • specs/<feature>/implementation-status.md if present
  • specs/<feature>/review.md if present
  • specs/<feature>/drift.md if present
  • current code or task state only when resuming work

Shared template:

  • ../references/handoff-template.md

Owned Outputs

  • handoff.md
  • concise current-phase summary with accepted-vs-ready artifact distinctions when available
  • pending work, blockers, and exact recommended next reading path

Phase-Specific Rejected Criteria

Return rejected if the request actually asks for architecture design, implementation, or verification instead of continuity packaging.

Phase-Specific Blocked Criteria

Return blocked if the current phase, completed work, or blockers cannot be determined from repository state.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

shaowei-g/codex-skills

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

0 0
Explore
shaowei-g/codex-skills

ekoen-frontend-code-review

Production-grade code review for the eKoEN frontend codebase. Use when asked to review, audit, inspect, or harden eKoEN React/Next.js frontend code, pages, components, hooks, API clients, or state layers for bugs, performance bottlenecks, TypeScript safety issues, request inefficiency, state-management risks, memory leaks, rendering regressions, error-handling gaps, duplication, or maintainability problems, especially when a structured severity-ranked report with code locations, root causes, suggested fixes, and example refactors is required.

0 0
Explore
shaowei-g/codex-skills

ekoen-backend.doc.route-error

Add HttpErrorRes responses to eKoEN backend routes when controllers can throw errors from app/util/errors/index.ts

0 0
Explore
shaowei-g/codex-skills

conventional-commit-helper

Generate and validate Conventional Commit messages for semantic-release workflows. Use when a user asks to write a commit message, asks to commit changes, asks for commit type/scope selection, or asks to enforce Conventional Commits consistency.

0 0
Explore
shaowei-g/codex-skills

codex-cli-subagent-transport

Use only when native subagent execution is unavailable and the caller needs one deterministic Codex CLI run with repo-local artifacts and a manifest-based result contract.

0 0
Explore
shaowei-g/codex-skills

skill-usage-logger

All skill MUST use this logger to record usage events in NDJSON format.Log Codex skill usage events to NDJSON with safe concurrent appends.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results