shipit-kit:status

Report progress and next actions for a ShipIT feature branch.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/jrmatherly/shipit --skill shipit-kit-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shipit-kit:status
Source: https://github.com/jrmatherly/shipit/tree/main/.claude/skills/shipit-kit-status
Command: npx skills add https://github.com/jrmatherly/shipit --skill shipit-kit-status

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly orients developers and agents to the current feature branch by synthesizing branch info, spec files, recent commits, and task state into a concise status and a single clear next action so work can resume without hunting for context.

Core Features & Use Cases

  • Detects the active git branch and locates the matching specs/NNN-* feature directory to gather feature.yaml, tasks.yaml, and spec.yaml.
  • Summarizes completed work from commits and task states, lists remaining tasks or blockers, and provides precise verification steps to try the feature locally.
  • Use cases: resuming paused agent sessions, onboarding a reviewer, or confirming readiness before opening a PR.

Quick Start

Ask the skill to show the current feature status and the single next action for the active git branch.

Frequently Asked Questions about shipit-kit:status

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

FAQPage Schema
How do I check feature branch status and remaining tasks in git?

To check feature branch status, the skill reads git branch info, specs/NNN-* feature.yaml, tasks.yaml, and recent commits to summarize completed work and output remaining tasks. It synthesizes branch context into a concise progress report with a single clear next action.

What is ShipIT spec tracking and when do I need it for resuming work?

ShipIT spec tracking organizes feature development using specs/NNN-* directories containing feature.yaml, tasks.yaml, and spec.yaml. You need it when resuming paused agent sessions or onboarding reviewers, as it synthesizes task state and commit history to provide immediate context without manual hunting.

How to get next steps and verification steps for a feature branch?

Getting next steps involves analyzing task states from tasks.yaml alongside recent git commit history. The skill delivers precise verification steps to try the feature locally, listing remaining tasks or blockers and providing a single actionable next step so development can resume immediately.

Does this feature status tool work with repositories using ShipIT specs?

Yes, this feature status tool applies specifically to repositories using ShipIT specs. It requires read access to the repository to inspect specs/NNN-* feature directories, run git commands, and read spec files like feature.yaml and tasks.yaml to determine completed work and remaining tasks.

Can I confirm PR readiness by checking completed work and blockers?

You can confirm PR readiness by having the skill summarize completed work from commits and task states. It lists remaining tasks or blockers and provides explicit verification steps, allowing you to assess whether the feature branch is ready before opening a pull request.

What's the best way to orient a reviewer on a feature branch?

The best way to orient a reviewer is generating a concise status report that synthesizes branch info, spec files, and recent commits. The skill provides a short actionable summary with explicit verification steps, enabling reviewers to understand feature status and test locally without searching for context.