agentleFS
Magnus-GilleMagnus-Gille/claude-skills/ship-it/SKILL.md

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

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.
  • jidechaoSkill

    modern-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

  • jidechaoSkill

    loop-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

  • SentrySkill

    create-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

  • GitHubSkill

    refactor

    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

  • GoogleSkill

    to-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 FaceSkill

    simplify

    Refactor code after tests pass. The "Refactor" phase of Red-Green-Refactor.

    Also in 3 projects that use this

  • +2 more from jidechao

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
  1. Distinctive:

    Use one delivery workflow for a scoped task in its owning repository.

    line 11
  2. Distinctive:

    Every autonomous mutation must leave an audit event and reversal recipe.

    line 22
  3. Distinctive:

    Do not advance to a later endpoint because it appears convenient or because a gate is green.

    line 41
  4. Distinctive:

    Every review and review gate in this workflow is an agentic technical review.

    line 47
  5. Distinctive:

    Review: After deterministic checks pass, freeze the candidate diff and relevant source for independent cross-model review.

    line 77
  6. Distinctive:

    Merge when requested: Only for a merge or verified-production endpoint, recheck the head, base, review dispositions, required checks, and …

    line 107
  7. Distinctive:

    Verify a successful automatic rollout once.

    line 121

“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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.