@igor-guari/pi-skill-handoff 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Matt Pocock
+Copyright (c) 2025 Igor Guariroba
+
+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.

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# pi-skill-handoff
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![Pi Package](https://img.shields.io/badge/pi--package-skill-blue)](https://github.com/IgorGuariroba/pi-skill-handoff)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**handoff** skill for the **[Pi coding agent](https://pi.dev)**, adapted from Matt Pocock's Engineering Skills.
+
+> Compact the current conversation into a handoff document for another agent to pick up.
+
+---
+
+## Installation
+
+Install directly into Pi using `pi install`:
+
+```bash
+pi install git:github.com/IgorGuariroba/pi-skill-handoff
+```
+
+Or clone into your local/global skills directory:
+
+```bash
+# Global Pi skills directory:
+git clone https://github.com/IgorGuariroba/pi-skill-handoff.git ~/.pi/agent/skills/handoff
+
+# Or Agent Skills standard path:
+git clone https://github.com/IgorGuariroba/pi-skill-handoff.git ~/.agents/skills/handoff
+```
+
+---
+
+## Usage
+
+Trigger it explicitly in your session:
+
+```text
+/skill:handoff
+```
+
+Or let Pi automatically route to it based on conversation context and need.
+
+---
+
+## Credits
+
+- **Original concept & methodology**: [Matt Pocock](https://github.com/mattpocock)
+- **Adapted for Pi Agent**: [Igor Guariroba](https://github.com/IgorGuariroba)
+
+---
+
+## License
+
+[MIT](LICENSE)

package/SKILL.md

@@ -0,0 +1,23 @@
+---
+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?
+disable-model-invocation: true
+license: MIT
+metadata:
+  author: Matt Pocock
+  adapted_by: Igor Guariroba
+  version: 1.0.0
+---
+
+
+Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS (`$TMPDIR`, else `/tmp`; `%TEMP%` on Windows) - not the current workspace.
+
+Include a "suggested skills" section with each skill's name, absolute `SKILL.md` path and the condition for reading it. The next Pi agent loads those instructions through file reads; the user can also invoke an installed skill explicitly with `/skill:name`.
+
+Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
+
+Redact any sensitive information, such as API keys, passwords, or personally identifiable information.
+
+If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.

package/package.json

@@ -1,6 +1,28 @@
 {
   "name": "@igor-guari/pi-skill-handoff",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Compact the current conversation into a handoff document for another agent to pick up.",
+  "keywords": [
+    "pi-package",
+    "pi-skill",
+    "pi",
+    "handoff",
+    "engineering-skills"
+  ],
+  "author": "Igor Guariroba",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/IgorGuariroba/pi-skill-handoff.git"
+  },
+  "homepage": "https://github.com/IgorGuariroba/pi-skill-handoff#readme",
+  "pi": {
+    "skills": [
+      "."
+    ]
+  },
+  "files": [
+    "SKILL.md",
+    "*.md"
+  ]
+}