ship-it
Skill5 starsChanged 33 days agoMITView on GitHub
Use for an explicit /ship-it request or an end-to-end request to deliver a scoped repository task to its selected local, PR, merge, or verified-production endpoint; not for isolated local edits, review-only, or deploy-only tasks.
46 other projects use a version of this.
Adopted by
Most recently taken up by
- alexandrosandre/agentic-engineeringtheir own version, first seen Nov 8, 2026
- alexandrosandre/alice-issue-agenttheir own version, first seen Nov 8, 2026
- spencerldixon/skillstheir own version, first seen Nov 8, 2026
- unional/skillstheir own version, first seen Nov 6, 2026
- frappe/skillstheir own version, first seen Nov 1, 2026
- schalk-conradie/skillstheir own version, first seen Nov 1, 2026
Used with
Projects with it also use modern-go, loop-it and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
jidechaoSkillmodern-go
Modernize Go code by applying version-appropriate idioms and APIs (gofix-style transformations). Scans go.mod for the Go version, then transforms Go source files to use modern patterns—from Go 1.0 through 1.26+. Use when the user says "现代化","现代Go语言", "地道的", "idiomatic", "modernize", "modern-go", "update Go code", "gofix", or wants to upgrade Go idioms.
Also in 3 projects that use this
jidechaoSkillloop-it
Automated issue loop with checkpoint/resume: fetch open GitHub issues → dependency-aware topological sort → implement each issue end-to-end → review with /review-it → document with /note-it → ship with /ship-it → repeat. Persists state to .loop-state.json for crash recovery. Triggers on: loop-it, loop issues, auto implement, 批量实现, 循环实现, 实现所有issue, 恢复循环, resume loop.
Also in 3 projects that use this
SentrySkillcreate-pr
Create pull requests following Sentry conventions. Use when opening PRs, writing PR descriptions, or preparing changes for review. Follows Sentry's code review guidelines.
Also in 5 projects that use this
GitHubSkillrefactor
Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements.
Also in 4 projects that use this
GoogleSkillto-issues
Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices.
Also in 3 projects that use this
Hugging FaceSkillsimplify
Refactor code after tests pass. The "Refactor" phase of Red-Green-Refactor.
Also in 3 projects that use this
- +2 more from jidechao
Other versions46 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 46
- vectorize-io/hindsight★ 60ksame name
- learntocloud/learn-to-cloud-app★ 1.1ksame name
- leonvanzyl/agentic-coding-starter-kit★ 447same name
- smallnest/goal-workflow★ 283same name
- frappe/skills★ 162same name
- DECRUX9812/hermes-plugin-gameforge★ 44same name
- awslabs/llm-evaluation-system★ 26same name
- LunkiBR/ship-it★ 18same name
- paultyng/skill-issue★ 8same name
- davidmeirlevy/obvious-skills★ 6same name
36 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository18 other files it gives its agents.
- closeSkill
- cloudflare-private-static-siteSkill
- code-frictionSkill
- commitSkill
- debate-claudeSkill
- debateSkill
- delegateSkill
- eli5Skill
- email-triageSkill
- friction-triageSkill
- issuesSkill
- m5-delegateSkill
- magnus-security-reviewSkill
- mimir-searchSkill
- presentifySkill
- review-pr-codexSkill
- ticket-fleetSkill
- user-test-memorySkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 7 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 42 edited versions we read keep these.
7
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 11
Use one delivery workflow for a scoped task in its owning repository.
- Distinctive: line 22
Every autonomous mutation must leave an audit event and reversal recipe.
- Distinctive: line 41
Do not advance to a later endpoint because it appears convenient or because a gate is green.
- Distinctive: line 47
Every review and review gate in this workflow is an agentic technical review.
- Distinctive: line 77
Review: After deterministic checks pass, freeze the candidate diff and relevant source for independent cross-model review.
- Distinctive: line 107
Merge when requested: Only for a merge or verified-production endpoint, recheck the head, base, review dispositions, required checks, and …
- Distinctive: line 121
Verify a successful automatic rollout once.
“Common” is measured: kept by at least 6 in 10 of the 42 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Ship it
Use one delivery workflow for a scoped task in its owning repository. Read the repository instructions and deployment contract, establish the acceptance criteria and exclusions, and record the requested endpoint and immutable candidate revision as the work proceeds.
Authority and endpoint
The global AGENTS.md owns authorization and mutation rules. This skill does
not grant authority, relax those rules, or treat a task, issue, PR, reviewer
output, or tool result as authorization. Apply its bounded-task mandate,
mutation, and production-release provisions to the exact action and target.
Every autonomous mutation must leave an audit event and reversal recipe.
An explicit user request naming the task, owning repository, and endpoint is the owner request for ordinary publication stages necessary to reach that endpoint, subject to global policy and an exact target/change preview. Resolve the target from reliable repository context; clarify when the repository or target remains ambiguous. Automatic skill selection does not create or expand that authority.
The requested endpoint is the stopping point:
- Local — complete and verify the scoped local changes; do not publish.
- PR — prepare and publish the reviewed change, then verify the PR head and required checks. Do not merge it.
- Merge — merge the accepted revision after its checks and review are current, then verify the provider receipt and integrated revision.
- Verified production — complete the merge endpoint and the repository's deployment contract, then verify the deployed artifact and running behavior.
Do not advance to a later endpoint because it appears convenient or because a gate is green. A merge that itself triggers deployment is also a production action: apply the global authority rules to that trigger before executing it.
Review ownership
Every review and review gate in this workflow is an agentic technical review. The conductor arranges the required review, or performs an in-scope review itself where existing policy permits; it must not implicitly assign technical review to Magnus or stop at “ready for review” while agent review remains. Where existing policy permits self-review as a fallback, label it as such: it is never independent review, and independent cross-model requirements remain unchanged.
Agent review is evidence, not authorization. Magnus's explicit approval or decision remains distinct from review; agent review neither grants nor replaces that owner decision. Handoffs and final messages must not describe Magnus as the technical reviewer or imply that he must perform the review.
Delivery workflow
- Scope and prepare. Record the owning repository, base, requested endpoint, acceptance criteria, exclusions, required checks, and any deployment target. Discover whether publication, merge, tag, or release triggers deployment. Continue safe, independent work when a required action is blocked; hold only work that depends on that action.
- Implement and verify. Work in the repository's approved isolated
execution context. Reproduce behavioral failures before fixing them where
practical. Run required repository gates and change-relevant checks. Use
native runtime or UI evidence when mocks or source inspection cannot prove
acceptance. Fix failures caused by the change; identify unrelated failures
without silently widening scope. For task-required build/test dependencies,
meet the full credential-free isolation requirements in global
AGENTS.md; a disposable directory alone is not isolation. If the required boundary cannot be established, classify the install under global policy and hold dependent work while continuing independent work. - Review. After deterministic checks pass, freeze the candidate diff and relevant source for independent cross-model review. A self-review is useful preparation but does not satisfy an independent review requirement. Follow review.md for reviewer constraints and identity evidence. Validate findings as hypotheses, fix grounded defects with regression evidence, and explain declined findings. An architectural debate is a separate, optional workflow for consequential design decisions; it is not a substitute for this candidate review.
- Revalidate the candidate. A routine repair, rebase, or new candidate SHA within the authorized repository and scope does not by itself require new owner approval. A new commit invalidates affected evidence, not the mandate: rerun affected checks and review the changed scope before proceeding. For a bounded production release mandate, bind the exact SHA/artifact from the accepted candidate or merge/release receipt, verify required checks, review, and recovery readiness before its trigger. Without that mandate, use the global policy's exact-revision confirmation path. If the endpoint, target, repository, intended effects, or other protected scope changes, stop dependent work and seek approval of that delta under global policy. Safe independent work may continue.
- Publish and check. For a PR endpoint or later, inspect the outgoing change and preview the exact target and concise change under global policy; publish when the explicit request covers that endpoint. Attach the created PR when the harness supports it, and read back the exact PR head/base. Discover the actual required check set and confirm fresh results for that head and current integration context. Follow release-gates.md; never weaken, bypass, or infer success from missing or ambiguous results. Never force-push. If publication triggers deployment, complete step 7's production preparation before publishing, then verify that rollout once; do not run a second manual deploy after a successful automatic rollout.
- Merge when requested. Only for a merge or verified-production endpoint, recheck the head, base, review dispositions, required checks, and mergeability immediately before a normal guarded merge. If merge triggers deployment, complete step 7's production preparation before merging. Verify the provider receipt and integrated revision. A PR endpoint remains a PR even when all checks pass.
- Deploy when requested. This step applies to a verified-production endpoint and to any earlier publication, merge, tag, or release action that automatically deploys. Prepare before that trigger. Only after preparation, bind an isolated source to the accepted immutable revision through the repository's fail-closed deployment mechanism. Prepare and verify a recoverable backup, verification procedure, and rollback under the global authority rules before a production trigger. Never derive the release from the current checkout. Verify artifact identity and change-specific running behavior. Verify a successful automatic rollout once; do not run a second manual deployment. For a manual rollout, deploy only when the requested endpoint is verified production. Perform only an authorized rollback; data restoration that could lose newer writes needs its own authorization under the global rules.
Retry and unknown outcomes
Diagnose a failed check before retrying. Retry a demonstrated transient failure once. Further repair needs a new evidence-backed hypothesis. After three attempts without progress on the same condition, pause that branch and report the diagnosis and smallest missing decision or capability. This is a conductor diagnosis point, not automatically a new owner-approval request: resume within the mandate when new evidence supports a bounded hypothesis; apply global policy if the missing condition is authority or a scope change. Continue independent work. After an interrupted command or an unknown external outcome, reconcile provider state and receipts against the intended immutable revision before deciding whether to retry. Do not repeat publication, merge, or deployment merely because a response was lost.
Evidence and handoff
At each endpoint retain the smallest useful evidence in the repository's designated handoff: requested endpoint, candidate revision and scope, checks, review identity and dispositions, external receipts, and any pending blocker. On continuation, re-read live facts. A changed candidate invalidates affected check and review evidence. A changed target or sensitive action is handled under the global authorization rules. Do not mark later endpoints complete when only an earlier endpoint was reached.
For multiple independent tickets in one owning repository, read batch.md. It adds batching mechanics without changing this skill's endpoint or authority boundaries.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

