How do I install the Ship It skill?

Run npx skillmds@latest add vltansky/ship-it in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ship It safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ship It?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ship It free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ship It?

vltansky (@vltansky) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ship It by vltansky — Agent Skill

Name: Ship It
Author: vltansky

File contents

Create PR

Step 1: Check state

git branch --show-current && git status -s && git diff HEAD --stat

Detect username: git config user.name or extract from branch prefix
If on master/main/prod: create a feature branch:

git checkout -b <username>/<feature-name>

Branch name from the diff context — short, descriptive, kebab-case.

Step 2: Commit + Push

If uncommitted changes exist:

If staged files exist (respect user's selection):

git commit -m "<msg>" && git push -u origin HEAD

If no staged files (stage everything):

git add . && git commit -m "<msg>" && git push -u origin HEAD

Commit message: conventional format (feat:, fix:, refactor:, etc.), concise.

Step 3: Generate AI Session Context

Generate a privacy-safe summary for reviewers from the current conversation.

You already have full context of:

What problem was discussed
What approaches were considered
What decisions were made and why
What trade-offs were evaluated

Synthesize directly from your memory of this session.

What to include vs exclude

Include	Exclude
Problem being solved	Exact user prompts
Solution approach chosen	Mistakes/failed attempts
Key decisions + WHY	Debugging struggles
Trade-offs considered	Personal info/credentials
Technical rationale	Anything embarrassing

Format as collapsible block

<details>
<summary>AI Session Context</summary>

**Problem:** [1 sentence - what was broken/needed]

**Approach:** [1 sentence - solution strategy]

**Key Decisions:**
- [Decision]: [Rationale - the WHY]
- [Decision]: [Rationale - the WHY]

**Trade-offs Considered:**
- [Option A vs B]: Chose A because [reason]

</details>

Skip Conditions

Skip AI Session Context if:

Trivial change (typo, version bump, config)
No meaningful decisions were made
User says "no context" or "skip context"

Step 4: Create PR

Format:

<feature_area>: <Title> (80 chars max)

<TLDR> (1-2 sentences)

- bullet 1
- bullet 2

<details>
<summary>AI Session Context</summary>
...
</details>

gh pr create --title "<title>" --body "<body>"

Display the returned PR URL on its own line so it's clickable.

---name: ship-itdescription: Create a GitHub PR with conventional format and AI session context. Use when user says 'create PR', 'open PR', 'submit changes', 'send to dev', 'ship it', or is done with their task.---# Create PR## Step 1: Check state```bashgit branch --show-current && git status -s && git diff HEAD --stat```- Detect username: `git config user.name` or extract from branch prefix- If on `master`/`main`/`prod`: create a feature branch:```bashgit checkout -b <username>/<feature-name>```Branch name from the diff context — short, descriptive, kebab-case.## Step 2: Commit + PushIf uncommitted changes exist:**If staged files exist** (respect user's selection):```bashgit commit -m "<msg>" && git push -u origin HEAD```**If no staged files** (stage everything):```bashgit add . && git commit -m "<msg>" && git push -u origin HEAD```Commit message: conventional format (`feat:`, `fix:`, `refactor:`, etc.), concise.## Step 3: Generate AI Session ContextGenerate a privacy-safe summary for reviewers from the current conversation.You already have full context of:- What problem was discussed- What approaches were considered- What decisions were made and why- What trade-offs were evaluatedSynthesize directly from your memory of this session.### What to include vs exclude| Include | Exclude ||---------|---------|| Problem being solved | Exact user prompts || Solution approach chosen | Mistakes/failed attempts || Key decisions + WHY | Debugging struggles || Trade-offs considered | Personal info/credentials || Technical rationale | Anything embarrassing |### Format as collapsible block```markdown<details><summary>AI Session Context</summary>**Problem:** [1 sentence - what was broken/needed]**Approach:** [1 sentence - solution strategy]**Key Decisions:**- [Decision]: [Rationale - the WHY]- [Decision]: [Rationale - the WHY]**Trade-offs Considered:**- [Option A vs B]: Chose A because [reason]</details>```### Skip ConditionsSkip AI Session Context if:- Trivial change (typo, version bump, config)- No meaningful decisions were made- User says "no context" or "skip context"## Step 4: Create PR**Format:**```<feature_area>: <Title> (80 chars max)<TLDR> (1-2 sentences)- bullet 1- bullet 2<details><summary>AI Session Context</summary>...</details>``````bashgh pr create --title "<title>" --body "<body>"```Display the returned PR URL on its own line so it's clickable.

Frequently asked questions

Ship It