@skilly-hand/skilly-hand 0.29.0 → 0.29.1

package/CHANGELOG.md

@@ -16,6 +16,21 @@ All notable changes to this project are documented in this file.
 ### Removed
 - _None._
 
+## [0.29.1] - 2026-05-23
+[View on npm](https://www.npmjs.com/package/@skilly-hand/skilly-hand/v/0.29.1)
+
+### Added
+- Added `context-handoff` for compact, privacy-aware session handoffs across agent chats.
+
+### Changed
+- _None._
+
+### Fixed
+- _None._
+
+### Removed
+- _None._
+
 ## [0.29.0] - 2026-05-23
 [View on npm](https://www.npmjs.com/package/@skilly-hand/skilly-hand/v/0.29.0)
 

package/catalog/README.md

@@ -7,6 +7,7 @@ Published portable skills consumed by the `skilly-hand` CLI.
 | `accessibility-audit` | Audit web accessibility against W3C WCAG 2.2 Level AA using framework-agnostic checks, remediation patterns, and portable command-line scanning. | frontend, accessibility, workflow, quality | all |
 | `agents-root-orchestrator` | Author root AGENTS.md as a Where/What/When orchestrator that routes tasks and skill invocation clearly. | core, workflow, orchestration | all |
 | `angular-guidelines` | Guide Angular code generation, review, and performance tuning using latest stable Angular verification, official Angular skill guidance, and modern framework best practices. Trigger: generating, reviewing, refactoring, or optimizing Angular code artifacts in Angular projects. | angular, frontend, workflow, best-practices | all |
+| `context-handoff` | Capture compact, neutral, AI-ready Markdown handoffs that preserve session context across chats without becoming a full transcript or personal memory store. Trigger: summarizing, compacting, preserving, or handing off session context across chats. | core, workflow, memory, communication | all |
 | `figma-mcp-0to1` | Guide users from Figma MCP installation and authentication through first canvas creation, with function-level tool coverage and operational recovery patterns. | figma, mcp, workflow, design | all |
 | `forge-me-a-skill` | Create and standardize AI skills with reusable structure, metadata rules, and templates. | core, workflow, authoring | all |
 | `frontend-design` | Project-aware frontend design skill that detects the existing tech stack, UI libraries, CSS variables, and design tokens before proposing any UI work. Supports greenfield projects via DESIGN.md context setup, taste-reference extraction, post-generation critique, visual refinement, and Motion/GSAP-aware motion polish. | frontend, design, workflow, ui, motion, greenfield | all |

package/catalog/skills/context-handoff/SKILL.md

@@ -0,0 +1,148 @@
+---
+name: "context-handoff"
+description: "Capture compact, neutral, AI-ready Markdown handoffs that preserve session context across chats without becoming a full transcript or personal memory store. Trigger: summarizing, compacting, preserving, or handing off session context across chats."
+skillMetadata:
+  author: "skilly-hand"
+  last-edit: "2026-05-23"
+  license: "Apache-2.0"
+  version: "1.0.0"
+  changelog: "Added context-handoff skill for project-local session continuity; preserves compact verified context across chats without transcript bloat; affects catalog skill routing and handoff-writing workflows"
+  auto-invoke: "Summarizing, compacting, preserving, or handing off session context across chats"
+  allowed-tools:
+    - "Read"
+    - "Edit"
+    - "Write"
+    - "Glob"
+    - "Grep"
+    - "Bash"
+    - "Task"
+---
+# Context Handoff Guide
+
+## When to Use
+
+Use this skill when:
+
+- A user asks to summarize, compact, preserve, or hand off session context.
+- Work may continue in a later chat, agent session, branch, or review.
+- Important decisions, current state, artifacts, unresolved questions, or next actions would otherwise be lost.
+- A project needs a concise `.context/` Markdown handoff that is readable by humans and useful to future AI agents.
+
+Do not use this skill for:
+
+- Full transcript archiving by default.
+- Personal journaling, private memory claims, or speculative profile building.
+- Critiquing the session, evaluating the user, or adding opinions not requested.
+- Replacing formal specs, issue trackers, changelogs, ADRs, or release notes when those are the better source of truth.
+
+---
+
+## Critical Patterns
+
+### Pattern 1: Store Project-Local Context
+
+Write handoff files under `.context/` in the active project root.
+
+Use this filename format:
+
+```text
+.context/YYYY-MM-DDTHHMMSSZ-context-handoff-<slug>.md
+```
+
+The folder is for project-local context handoffs. It is not personal memory, hidden long-term recall, or a place to dump raw chat history.
+
+### Pattern 2: Capture Verified Context Only
+
+Write as a professional transcriber and technical handoff writer:
+
+- Preserve facts from the session, repository, commands, files, decisions, and user-provided constraints.
+- Mark uncertainty explicitly as `Unknown`, `Unresolved`, or `Assumption`.
+- Do not invent motivations, conclusions, files, tests, or status.
+- Do not critique the user, the plan, or the implementation unless the user explicitly requested critique and it belongs in the handoff.
+
+### Pattern 3: Prefer Compact Handoff Over Transcript
+
+Default to a concise, structured handoff that a future agent can scan quickly.
+
+Include:
+
+- Purpose and current state.
+- Key context and constraints.
+- Decisions made.
+- Artifacts touched or produced.
+- Open questions and blockers.
+- Next actions.
+- Verification status.
+- A resume prompt.
+
+Exclude:
+
+- Routine back-and-forth.
+- Long command logs unless the exact output is essential.
+- Sensitive data, secrets, credentials, tokens, or private personal details.
+- Repeated explanations already captured in a durable project artifact.
+
+### Pattern 4: Screen Before Writing
+
+Before creating or updating a `.context/` file:
+
+1. Check whether the handoff may include secrets, credentials, tokens, private personal data, or proprietary data the user did not ask to persist.
+2. Redact sensitive values and describe them generically.
+3. If the user explicitly asks to persist sensitive content, confirm before writing it.
+4. Keep the handoff scoped to what future work needs.
+
+---
+
+## Decision Tree
+
+```text
+User asks to preserve or resume session context?       -> Create `.context/` handoff
+User asks for exact transcript or quotes?              -> Ask whether full transcript is required
+Formal requirement/spec/change log is needed?          -> Route to the appropriate durable artifact
+Sensitive content would be persisted?                  -> Redact or confirm before writing
+Context is uncertain or inferred?                      -> Label as Unknown, Unresolved, or Assumption
+Otherwise                                             -> Write compact neutral handoff
+```
+
+---
+
+## Examples
+
+### Example 1: Handoff Request
+
+```text
+Request: "Summarize this session so we can continue tomorrow."
+Action: Create `.context/2026-05-23T184512Z-context-handoff-auth-refactor.md` with current state, decisions, artifacts, open questions, next actions, verification, and resume prompt.
+```
+
+### Example 2: Privacy-Safe Capture
+
+```text
+Request: "Save the deployment notes, including the token I pasted."
+Action: Redact the token, record that a deployment token was provided in-session, and confirm before persisting any exact secret value.
+```
+
+### Example 3: Not a Critique
+
+```text
+Request: "Make a handoff from this planning session."
+Action: Record agreed scope, assumptions, unresolved decisions, and next steps. Do not rate the plan or add unsolicited objections.
+```
+
+---
+
+## Commands
+
+```bash
+mkdir -p .context
+date -u +"%Y-%m-%dT%H%M%SZ"
+rg -n "TODO|FIXME|Assumption|Unresolved" .context
+```
+
+---
+
+## Resources
+
+- Handoff template: [assets/handoff-template.md](assets/handoff-template.md)
+- Related compact output skill: [../output-optimizer/SKILL.md](../output-optimizer/SKILL.md)
+- Related planning workflow: [../spec-driven-development/SKILL.md](../spec-driven-development/SKILL.md)

package/catalog/skills/context-handoff/assets/handoff-template.md

@@ -0,0 +1,54 @@
+# {Title}
+
+---
+id: "{YYYY-MM-DDTHHMMSSZ-context-handoff-slug}"
+title: "{Title}"
+created_at: "{YYYY-MM-DDTHHMMSSZ}"
+source: "{session | repo | review | implementation | planning}"
+status: "{draft | ready | superseded}"
+tags: ["context-handoff"]
+---
+
+## Purpose
+
+{Why this handoff exists and what future work it should enable.}
+
+## Current State
+
+{Verified state of the work, repo, artifacts, branch, tests, or decisions at the time of capture.}
+
+## Key Context
+
+- {Important fact, constraint, preference, or dependency.}
+- {Important fact, constraint, preference, or dependency.}
+
+## Decisions
+
+- {Decision made, with brief reason if known.}
+- {Decision made, with brief reason if known.}
+
+## Artifacts
+
+- `{path-or-url}`: {what it is and why it matters.}
+- `{path-or-url}`: {what it is and why it matters.}
+
+## Open Questions
+
+- {Unknown, unresolved point, or decision still needed.}
+- {Unknown, unresolved point, or decision still needed.}
+
+## Next Actions
+
+1. {Next concrete step.}
+2. {Next concrete step.}
+3. {Next concrete step.}
+
+## Verification
+
+{Checks run, checks not run, observed results, and remaining verification risk.}
+
+## Resume Prompt
+
+```text
+Continue from this handoff. First read this file, verify current repo state, then proceed with: {specific next objective}.
+```

package/catalog/skills/context-handoff/manifest.json

@@ -0,0 +1,33 @@
+{
+  "id": "context-handoff",
+  "title": "Context Handoff",
+  "description": "Capture compact, neutral, AI-ready Markdown handoffs that preserve session context across chats without becoming a full transcript or personal memory store. Trigger: summarizing, compacting, preserving, or handing off session context across chats.",
+  "portable": true,
+  "tags": ["core", "workflow", "memory", "communication"],
+  "detectors": ["always"],
+  "detectionTriggers": ["always"],
+  "installsFor": ["all"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
+  "skillMetadata": {
+    "author": "skilly-hand",
+    "last-edit": "2026-05-23",
+    "license": "Apache-2.0",
+    "version": "1.0.0",
+    "changelog": "Added context-handoff skill for project-local session continuity; preserves compact verified context across chats without transcript bloat; affects catalog skill routing and handoff-writing workflows",
+    "auto-invoke": "Summarizing, compacting, preserving, or handing off session context across chats",
+    "allowed-tools": [
+      "Read",
+      "Edit",
+      "Write",
+      "Glob",
+      "Grep",
+      "Bash",
+      "Task"
+    ]
+  },
+  "files": [
+    { "path": "SKILL.md", "kind": "instruction" },
+    { "path": "assets/handoff-template.md", "kind": "asset" }
+  ],
+  "dependencies": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/skilly-hand",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "repository": {

package/packages/catalog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/catalog",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "private": true,
   "type": "module"
 }

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/cli",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "private": true,
   "type": "module",
   "bin": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/core",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "private": true,
   "type": "module"
 }

package/packages/detectors/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/detectors",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "private": true,
   "type": "module"
 }