icn-shipping
Automates branch preparation and merge-readiness checks for ICN repositories.
Install
mkdir -p .claude/skills/icn-shipping && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13004" && unzip -o skill.zip -d .claude/skills/icn-shipping && rm skill.zipInstalls to .claude/skills/icn-shipping
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Prepare ICN branches for merge with required checks, doc/spec sync, clean git hygiene, and high-quality PR metadata.Key capabilities
- →Run required checks for touched paths
- →Remove unrelated edits to keep patch focused
- →Update documentation/spec if semantics changed
- →Ensure git status --short is clean except intended files
- →Write clear and scoped commit messages
- →Generate high-quality Pull Request metadata including problem, what changed, invariants, and verification
How it works
The skill prepares an ICN branch for merge by running required checks, ensuring diff quality, updating documentation, maintaining git hygiene, and generating complete Pull Request metadata.
Inputs & outputs
When to use icn-shipping
- →Running pre-merge checks
- →Syncing specs with implementation
- →Generating PR documentation
- →Cleaning up commit history before merge
About this skill
ICN Shipping Skill (Codex)
Use this skill when preparing a branch for merge.
Purpose
- Ensure code, docs, and PR metadata are release-quality.
- Prevent false-green claims and drift between behavior and docs.
Preconditions
- Implementation changes are complete.
- Required checks for touched areas are known from
AGENTS.md.
Shipping Checklist
- Verification
- Run required checks for touched paths.
- Capture command outputs before claiming success.
- Diff Quality
- Remove unrelated edits.
- Keep patch focused and reviewable.
- Documentation
- If semantics changed, update docs/spec in same PR.
- Git Hygiene
git status --shortis clean except intended files.- Commit message is clear and scoped.
- Branch pushed to remote.
- Pull Request Quality
- Title: concise, behavior-oriented.
- Body includes:
- Problem
- What changed
- Invariants/safety notes
- Verification commands and outcomes
- Follow-ups (if any)
Standard Verification Commands
- Rust crates:
cd icn && cargo fmt --all --checkcd icn && cargo clippy --workspace --all-targets --all-features -- -D warningscd icn && cargo test(or narrower scoped tests with justification)
- Docs-only changes:
- Link/consistency checks with
rgand manual spot validation.
- Link/consistency checks with
Stop Conditions
Do not ship if any required check fails, invariants are unclear, or docs drift is unresolved.
When not to use it
- →If any required check fails
- →If invariants are unclear
- →If docs drift is unresolved
Limitations
- →Does not ship if any required check fails
- →Does not ship if invariants are unclear
- →Does not ship if docs drift is unresolved
How it compares
This skill provides a structured checklist and specific commands for preparing a branch for merge within the ICN context, focusing on release-quality code, documentation, and PR metadata, which is more rigorous than a standard merge process
Compared to similar skills
icn-shipping side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| icn-shipping (this skill) | 0 | 6mo | No flags | Intermediate |
| release-skills | 2 | 3mo | Review | Intermediate |
| sync-upstream | 1 | 6mo | Review | Intermediate |
| code-review | 0 | 6mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
release-skills
JimLiu
Universal release workflow. Auto-detects version files and changelogs. Supports Node.js, Python, Rust, Claude Plugin, and generic projects. Use when user says "release", "发布", "new version", "bump version", "push", "推送".
sync-upstream
rust-lang-cn
Sync Chinese translation repository with upstream rust-lang/nomicon. Use when user wants to check for upstream changes, sync translations, update from upstream, or asks about differences between local translation and upstream English version. Triggers on requests like "sync upstream", "check upstream changes", "update from nomicon", or "sync translation".
code-review
jonatron55
Instructions for reviewing changes and ensuring quality before completion. Use when asking for a review or before committing changes.
ci-pr-helper
lance-format
Run local test/style checks and open GitHub PRs for lance-context. Use when asked to run CI-equivalent checks (uv pytest, ruff/pyright, cargo fmt/clippy/test) and then create a PR with a proper title/body.
pr
boundless-xyz
Create or update a pull request for the current git changes. Use when the user wants a PR, commit/push for review, or gh pr create flow.
release
k1-c
Check release readiness, preview changelog, and validate publishability. Use when preparing a release or checking version status.