What is project-spawn?

A tool for moving work to a new Claude Code or Codex session in another project directory. It creates a handoff with relevant conversation context and starts the selected coding agent there.

Use it when starting work in another project, transferring the last several relevant messages, creating a handoff file, and launching a focused session in the target directory.

It keeps the context of the current discussion when work shifts to a different repository or folder. It can also handle a missing directory and offer project setup choices.

project-spawn — Skill for Claude Code and Codex by buddyh/agent-skills

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add buddyh/agent-skills --skill project-spawn

Clone the repo

git clone --depth 1 https://github.com/buddyh/agent-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/buddyh/agent-skills/project-spawn/github.svg)](https://agentmods.dev/skills/buddyh/agent-skills/project-spawn)

Your own site

<a href="https://agentmods.dev/skills/buddyh/agent-skills/project-spawn"><img src="https://agentmods.dev/badge/skills/buddyh/agent-skills/project-spawn/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/buddyh/agent-skills/project-spawn"><img src="https://agentmods.dev/badge/skills/buddyh/agent-skills/project-spawn.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 73 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 866 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00073	$0.00866
Opus 5.5	$0.00029	$0.00346
Sonnet 5.5	$0.00015	$0.00173
Haiku 4.5	$0.00007	$0.00087

Measured 2mo ago against content hash 85b9dcce4ac6, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

project-spawn scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/spawn_session.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

project-spawn/SKILL.md · 135 lines

How it starts

The opening of the file, as written. The whole thing — 135 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Project Spawn

Overview

Transfer context from the current conversation to a new session in a different project directory. This enables seamless context handoff when pivoting from a general session to focused project work.

Platform Support

Claude Code: claude CLI
Codex: codex CLI

The handoff workflow is identical on both platforms.

Workflow

Step 1: Resolve Target Project

Determine the target project directory:

If explicit path/name provided: Use directly
If project name provided: Search for matching directories in common locations (~/repos/, ~/projects/, etc.)
If no target specified: Detect from recent conversation context or ask the user

Step 1b: Handle Non-Existent Directory

If target directory doesn't exist, ask user:

"Directory <path> doesn't exist. Want me to create it?"

Create folder only

Create folder + init git repo

Create folder + init git + create GitHub repo (public)

Create folder + init git + create GitHub repo (private)

Cancel

Create as requested before proceeding to Step 2.

Step 2: Extract Relevant Context

Analyze the last 5-10 messages for content relevant to the target project:

Tasks or work items discussed
Specific files, scripts, or features mentioned
Decisions made or questions raised
Any errors or issues identified
Uncommitted changes noted

Focus only on information relevant to the target project, not the entire conversation.

Step 3: Create Handoff Document

Write PROJECT_HANDOFF.md to the target project directory:

# Project Handoff - [DATE] [TIME]

## Context
[Why this handoff is happening - what triggered the pivot]

## Discussion Summary
[Relevant context extracted from conversation]

## Specific Tasks/Questions
- [Actionable items identified]

## Files/Areas Mentioned
- [Specific files or code areas referenced]

## Suggested Starting Point
[What to do first in this session]

Step 4: Launch Session

~/.claude/skills/project-spawn/scripts/spawn_session.sh "<project-path>" "<session-name>" [--agent claude|codex]

Read the full file on GitHub · 135 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

scripts/spawn_session.sh 1.3 KB runs code

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 135 lines · 73 tokens per session scan A 85b9dcce4ac6

Subscribe to this mod's changes

project-spawn is a skill published in the GitHub repository buddyh/agent-skills (5 stars, last pushed 3mo ago), licensed MIT. It adds 73 tokens to every session and 866 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Building agents Claude Code ai-agents claude skills

project-spawn next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
project-spawnbuddyh/agent-skills	Skill	5	3mo ago	MIT	A	73	Claude Code, Codex
claude-md-improveranthropics/claude-plugins-official	Skill	46k	yesterday	Apache-2.0	A	82	Claude Code
agent-platform-model-registrygoogle/skills	Skill	23k	today	Apache-2.0	A	60	Claude Code, Codex
gke-reliabilitygoogle/skills	Skill	23k	today	Apache-2.0	A	85	Claude Code, Codex
gke-workload-securitygoogle/skills	Skill	23k	today	Apache-2.0	A	171	Claude Code, Codex
google-cloud-solution-agentic-analytics-spark-knowledge-cataloggoogle/skills	Skill	23k	today	Apache-2.0	A	132	Claude Code, Codex
glance-canonical-layoutsandroid/skills	Skill	10k	2d ago	Apache-2.0	A	56	Claude Code