ship

Validate the working tree, verify spec alignment, and create an atomic micro-commit.

29|4|Updated Nov 22, 2025
One-click install
npx skills add https://github.com/villetakanen/asdlc-io --skill ship-villetakanen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/villetakanen/asdlc-io/tree/main/.agents/skills/ship
Command: npx skills add https://github.com/villetakanen/asdlc-io --skill ship-villetakanen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Ship Agent validates the working tree, verifies spec alignment, and creates an atomic micro-commit that can be pushed to the remote.

Core Features & Use Cases

  • Inventory and quality gates: lint, build, test, and check all changed files
  • Spec verification: ensure changed code stays aligned with its specs
  • Atomic save point: a single well-formed commit that captures changes and enables safe rollback

Quick Start

Initiate the ship workflow with a descriptive commit message to validate, commit, and push the changes atomically.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I automate git commit and push after passing lint, build, and test checks?

To automate git commit and push after passing lint, build, and test checks, use this Skill to validate your working tree and create an atomic micro-commit. It enforces quality gates and spec alignment before pushing to the remote branch.

What is an atomic micro-commit in a CI workflow?

An atomic micro-commit in a CI workflow is a single, well-formed save point that captures code changes and enables safe rollback. This Skill creates it by validating the working tree, verifying spec alignment, and pushing deterministically.

How do I ensure code changes stay aligned with specs before pushing to a remote branch?

To ensure code changes stay aligned with specs before pushing to a remote branch, this Skill verifies spec conformance as part of its validation process. It checks lint, build, and test results alongside spec alignment to guarantee a deterministic push.

Can I validate changed files for spec alignment without setting up a complex CI pipeline?

Yes, you can validate changed files for spec alignment without a complex CI pipeline by using this Skill to inventory changed files and run quality gates locally. It applies lint, build, test, and check validation directly to your working tree before committing.

What is the best way to create a safe rollback point for bounded development tasks?

The best way to create a safe rollback point for bounded development tasks is to generate an atomic save point through this Skill. It validates changes through lint, build, and test checks, then commits them atomically for safe and deterministic rollback.

Why does pushing code fail when specs and working tree validation are mismatched?

Pushing code fails when specs and working tree validation are mismatched because this Skill enforces strict quality gates and spec verification before creating a commit. It prevents non-compliant changes from being pushed to the remote branch to guarantee deterministic results.