submit

Sync beads state and create or update Graphite PRs via gt submit.

8|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/jfmyers9/claude --skill submit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: submit
Source: https://github.com/jfmyers9/claude/tree/main/skills/submit
Command: npx skills add https://github.com/jfmyers9/claude --skill submit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates syncing beads state and creating or updating PRs through Graphite, streamlining collaboration and feedback loops across branches.

Core Features & Use Cases

  • Sync beads state to export the current work context.
  • Validate a clean working tree before submitting changes.
  • Restack branches and construct PR submissions with optional flags (--stack, --ready).
  • Create or update PRs on Graphite, with default draft status and ability to control draft behavior.
  • Show resulting PR URLs for quick navigation and review.

Quick Start

Run the Submit Workflow to sync beads state and create or update a PR in Graphite, optionally passing --stack and/or --ready to control stacking and draft status.

Frequently Asked Questions about submit

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

FAQPage Schema
How do I automate PR creation and branch syncing using Graphite?

To automate PR creation with Graphite, this skill exports your beads state, validates a clean working tree, restacks branches, and executes the submit command to create or update pull requests with default draft status.

What does it mean to sync beads state before submitting a PR?

Syncing beads state exports the current work context from your local environment before submission. This ensures your branch structure and metadata are accurately reflected when creating or updating the PR on Graphite.

Can I control draft status and stacking when submitting PRs via Graphite?

Yes, you can control draft status and stacking by passing specific flags. Use --stack to manage stacked branch submissions and --ready to control whether the PR is published as a draft or marked as ready for review.

Do I need a clean working tree before submitting changes to Graphite?

Yes, a clean working tree is required before submitting changes to Graphite. The workflow includes a validation step to verify your working directory is clean, preventing uncommitted or untracked files from interfering with the PR submission.

How do I restack branches before creating a PR in Graphite?

Restacking branches before PR creation is handled automatically during the submit workflow. The process evaluates your current branch structure and executes the necessary restack operations to ensure dependencies are updated before submission.