ship-it

Enforce conventional commits and PR-based git workflows for controlled releases.

22|3|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/awslabs/llm-evaluation-system --skill ship-it-awslabs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship-it
Source: https://github.com/awslabs/llm-evaluation-system/tree/main/.claude/skills/ship-it
Command: npx skills add https://github.com/awslabs/llm-evaluation-system --skill ship-it-awslabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines end-to-end code shipping in a collaborative repo by enforcing conventional-commit messages, preventing direct main pushes, and guiding through feature-branch workflows, PR creation, and controlled releases.

Core Features & Use Cases

  • Enforces Conventional Commits for every commit and PR title to ensure changelog clarity and reviewability.
  • Prevents direct pushes to main and requires PR-based integration, with mandated branch cleanup after merges.
  • Guides end-to-end release workflows from feature development to publishing, including optional PyPI release steps.

Quick Start

Initiate a feature change on a new branch, commit with a conventional message, open a PR with a properly formatted title, and run the release steps after merge.

Frequently Asked Questions about ship-it

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

FAQPage Schema
How do I enforce conventional commits and prevent direct pushes to main?▼

To enforce conventional commits and prevent direct pushes to main, this skill applies guardrails for branch management, requiring feature-branch sponsorship and PR-based integration. It formats PR titles and mandates branch cleanup after merges.

What is the best way to manage a git workflow for predictable code releases?▼

The best way to manage a git workflow for predictable code releases is to follow a disciplined process. This skill guides end-to-end changes from feature-branch creation through conventional commits, PR creation, and controlled release procedures.

How do I step through a feature-branch workflow for a pull request?▼

To step through a feature-branch workflow for a pull request, initiate a feature change on a new branch, commit with a conventional message, open a PR with a properly formatted title, and run the post-merge release steps.

Can I use this skill for Python package publishing on PyPI?▼

Yes, you can use this skill for Python package publishing on PyPI. It guides end-to-end release workflows from feature development to publishing, including optional PyPI release steps after your pull request is merged.

Does this skill require direct pushes to main for code integration?▼

No, this skill prevents direct pushes to main for code integration. It requires pull-request based integration instead, enforcing conventional commit messages and formal release procedures to ensure predictable releases.

How does conventional commit formatting improve code releases?▼

Conventional commit formatting improves code releases by ensuring changelog clarity and reviewability. This skill enforces conventional commits for every commit and PR title to maintain disciplined git workflows.