branch-context-from-plan

Creates an implementation branch from a saved plan and attaches it as branch context.

2|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/nseng-ai/ns --skill branch-context-from-plan-nseng-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-context-from-plan
Source: https://github.com/nseng-ai/ns/tree/main/skills/incubating/branch-context/branch-context-from-plan
Command: npx skills add https://github.com/nseng-ai/ns --skill branch-context-from-plan-nseng-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a saved implementation plan into actual work requires manually creating a branch, naming it consistently, and keeping the plan linked to that branch for later reference. This Skill automates that handoff by resolving a saved plan file, creating the target branch, and attaching the plan as a named Markdown key in Branch Memory. ## Core Features & Use Cases - Plan Resolution: Resolves a saved plan file from an absolute or home-relative path before branching. - Branch Creation with Context: Creates the target branch via plain Git or Graphite and attaches the plan as a named Markdown key in Branch Memory. - Slug Derivation: Derives a kebab-case 3-7 word slug from plan content to drive the branch name and attached-plan key. - Use Case: After writing and saving an implementation plan, ask the agent to branch from that plan; it creates the branch, attaches the plan under a slug like add-oauth-login-flow.md, and reports the branch, namespace, key, and commit. ## Quick Start Ask the agent to create an implementation branch from your saved plan file and attach the plan as branch context.

Frequently Asked Questions about branch-context-from-plan

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

FAQPage Schema
How do I create a branch from a saved implementation plan?

Provide the absolute or home-relative path to your saved plan Markdown file. The skill resolves the plan, derives a kebab-case slug from its content, creates the target branch, and attaches the plan as a named Markdown key in Branch Memory.

How is the branch name derived from a plan?

The branch name comes from a slug derived from the plan content: kebab-case, 3-7 specific words, with no dates, random IDs, or generic-only names. This slug also determines the attached-plan key, which is stored as `<slug>.md`.

Does this work with Graphite stacked branches?

Yes, branch creation supports both plain Git and Graphite via the `--branch-creation` flag. In this repo Graphite is the default unless the user explicitly requests plain Git; if Graphite setup fails after branch creation, the partial branch state is reported.

What happens if the target branch already exists?

The skill stops and asks whether to choose a different `--branch` value or inspect the existing branch. It does not overwrite existing branches or existing Branch Memory entries; conflicts are reported with the namespace and key.

What if there is no saved plan to branch from?

The skill requires a saved plan file. If none exists, run the write-plan workflow first or provide an absolute or home-relative path to a `.md` plan file, which will be resolved before branching.