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.