spinoff

Seeds a new sibling GitHub repository from an adopter repo's agent infrastructure and stack scaffolding.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/vzakharov/vovazakharov.com --skill spinoff-vzakharov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spinoff
Source: https://github.com/vzakharov/vovazakharov.com/tree/main/.claude/skills/spinoff
Command: npx skills add https://github.com/vzakharov/vovazakharov.com --skill spinoff-vzakharov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating a new project that reuses an existing repository's agent infrastructure, lint discipline, build shape, and architectural conventions normally requires manual, error-prone copying. This Skill automates the triage of what should travel versus what stays behind, then seeds the new repository with a reviewed structure. ## Core Features & Use Cases - Three-way triage: Sorts every path in the source repo into stack scaffolding, agent infrastructure, or product, deciding per path whether it travels as a copy, a rewrite, or stated architectural intent when stacks differ. - Watermark and lineage management: Writes the new repo's sync watermark pointing at the root template, carrying the caller's lastSyncedSha and lineage array so future syncs compose correctly. - Reviewed seeding split: Lands already-reviewed copies on main and routes all rewrites through a draft PR, so the new repo passes through the same reviewed adoption path as any other project. - Use Case: You have a mature Next.js project with a working agent loop and want to start a sibling project in Python. Invoke /spinoff owner/new-repo, and the Skill carries the architectural decisions as intent, seeds main with the agent loop, and opens a draft PR with the rewritten foundation. ## Quick Start Invoke the skill by typing /spinoff owner/new-repo-name in a session rooted in the adopter repository, then answer the prompts about visibility and target stack.

Frequently Asked Questions about spinoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new repo that reuses my project's agent infrastructure?

Invoke /spinoff owner/name from a session rooted in your existing adopter repository. The skill triages which files travel, seeds main with the agent loop, opens a draft PR with the rewritten foundation, and hands back a command to open a session in the new repo.

Can I spin off a project into a different tech stack?

Yes, cross-stack spinoffs are supported. When stacks differ, organization travels as stated architectural intent recorded in the target's plan rather than as copied files, since nothing file-shaped can be copied between ecosystems.

Why does the spinoff skill refuse to run from some repositories?

It refuses when the caller contains a .claude/skills/*/catalog.md file, which indicates the repo is the template itself or an unpruned fork of it. Template repos should be forked instead, and unpruned forks should first run /detemplate.

What lands on main versus the draft PR when seeding a spinoff?

Main receives only already-reviewed copies: the agent skills, surviving rules, loop scripts, and editor config. All rewrites such as CLAUDE.md, README.md, vet.sh, lint config, and deploy config arrive through draft PR #1 as reviewed work.

Does the new repo's sync watermark point at the repository it was spun off from?

No, the watermark always points at the root template, never at the caller. This keeps sync chains from composing across siblings, and the caller's lastSyncedSha is carried forward as the honest sync mark.