diff --git a/codex/skills/handoff/SKILL.md b/codex/skills/handoff/SKILL.md new file mode 100644 index 0000000..aaa2a8e --- /dev/null +++ b/codex/skills/handoff/SKILL.md @@ -0,0 +1,13 @@ +--- +name: handoff +description: Compact the current conversation into a handoff document for another agent to pick up. +argument-hint: "What will the next session be used for?" +--- + +Write a handoff document summarizing the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS - not the current workspace. + +Include a "suggested skills" section in the document, naming which installed skills the next agent should use. + +Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead. + +If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly. diff --git a/codex/skills/handoff/agents/openai.yaml b/codex/skills/handoff/agents/openai.yaml new file mode 100644 index 0000000..6e1d8da --- /dev/null +++ b/codex/skills/handoff/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Handoff" + short_description: "Compact a conversation into a handoff" +policy: + allow_implicit_invocation: false diff --git a/codex/skills/handoff/references/sources.md b/codex/skills/handoff/references/sources.md new file mode 100644 index 0000000..49305c5 --- /dev/null +++ b/codex/skills/handoff/references/sources.md @@ -0,0 +1,35 @@ +# Sources + +Read this provenance when auditing or revising Handoff, not during normal use. + +The skill is substantially derived from Matt Pocock's `handoff` skill: + +- Source: https://github.com/mattpocock/skills/blob/0ab1b63a410a03d3627979a109c8695de27af954/skills/productivity/handoff/SKILL.md +- Repository license: MIT +- Upstream copyright: Copyright (c) 2026 Matt Pocock + +Compass keeps the upstream temporary-directory rule, suggested-skills section, artifact-reference discipline, redaction requirement, and argument-based focus. The only behavioral wording change translates Matt's Claude-style instruction to call the Skill tool into the portable requirement to name installed skills the next agent should use. + +## Upstream license + +MIT License + +Copyright (c) 2026 Matt Pocock + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/manifests/portable-files.json b/manifests/portable-files.json index fe20661..e7b9dc6 100644 --- a/manifests/portable-files.json +++ b/manifests/portable-files.json @@ -17,6 +17,7 @@ "design-prototype", "grilling", "ground-in-sources", + "handoff", "micro-experiment", "monitor", "no-comments",