by HouseAlone
A branch-aware Codex skill that saves compact project context, relevant skills, blockers, and next actions so you can start a fresh chat and continue work seamlessly—without carrying unnecessary history or wasting tokens.
# Add to your Claude Code skills
git clone https://github.com/HouseAlone/handshake-skillGuides for using ai agents skills like handshake-skill.
See how handshake-skill compares with popular alternatives.
handshake-skill is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by HouseAlone. A branch-aware Codex skill that saves compact project context, relevant skills, blockers, and next actions so you can start a fresh chat and continue work seamlessly—without carrying unnecessary history or wasting tokens. It has 0 GitHub stars.
handshake-skill's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/HouseAlone/handshake-skill" and add it to your Claude Code skills directory (see the Installation section above).
handshake-skill is primarily written in Python. It is open-source under HouseAlone on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh handshake-skill against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
See comparison
A branch-aware Codex skill that saves compact project context, relevant skills, blockers, and next actions so you can start a fresh chat and continue work seamlessly—without carrying unnecessary history or wasting tokens.
Handshake records the durable information an agent needs to pick up a project: current state, verified work, blockers, relevant skills, and ordered next actions. It keeps one summary per Git project and branch, reducing irrelevant context while preserving the details that move work forward.
Long agent sessions accumulate conversation history that is expensive and often irrelevant to the next task. Handshake closes a session with a compact, actionable summary, then opens the next session by restoring and verifying only the context needed to continue.
| Environment | Installation | Invocation |
|---|---|---|
| Codex | Copy handshake/ to ~/.codex/skills/handshake/ |
$handshake or $handshake close |
| Claude Code | Load this repository as a plugin | /handshake:handshake or /handshake:handshake close |
The saved handshake is shared across compatible installations on the same computer:
~/codex-session-handshakes/<project-key>/handshake-<branch>.md
Copy the standalone skill into your personal Codex skills directory:
cp -R handshake ~/.codex/skills/handshake
Restart Codex if the skill does not appear automatically.
Open a project session and continue from its saved context:
$handshake
Close the current session and replace its compact continuation context:
$handshake close
Test the plugin directly from a local clone:
claude --plugin-dir .
Then use the namespaced skill:
/handshake:handshake
/handshake:handshake close
The repository includes the required .claude-plugin/plugin.json manifest and skills/handshake/ package. It can be submitted to the Claude Code community marketplace after validation.
handshake/ # Standalone Codex skill
.claude-plugin/plugin.json # Claude Code plugin manifest
skills/handshake/ # Claude Code plugin skill
LICENSE # MIT
Issues and pull requests are welcome. Keep changes focused on reliable cross-session continuity and compact, durable project context.