CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ship

Commit and push the current work, open a ready PR, babysit it through CI and review, and admin-merge it once it's green and clean, then rotate the worktree to a fresh branch. Use when the user asks to ship, publish, or hand off local changes. Merging to main deploys beta automatically; production promotion is manual.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally well-engineered operational skill: precise ownership rules, a safety-checked merge gate, and feedback loops throughout. The residual gaps are minor — a missing explicit PR-creation command, slight redundancy with the description, and a few sections that could be split into references if the file grows.

Suggestions

Add the explicit PR-creation command (e.g., `gh pr create --title ... --body ...`) to step 3 so every user-facing action has a copy-paste-ready command.

Trim the opening paragraph, which restates the description's pipeline, and consider moving the Codex goal/heartbeat management details into a runtime-specific reference so the body stays runtime-neutral.

If the file grows further, split the worktree rotation and throwaway-worktree pruning rules (step 6) into a reference file to keep SKILL.md a lean overview.

DimensionReasoningScore

Conciseness

The body is dense and imperative with zero concept explanations ("Permission to push is not permission to merge", "Never enable auto-merge"), assuming Claude's competence. Minor trimmable material keeps it below lean-perfect: the opening paragraph restates the description's scope, and the Codex goal/heartbeat paragraph carries environment-specific detail that not every runtime needs.

4 / 5

Actionability

Mostly executable with copy-paste-ready commands: `gh pr merge <number> --squash --admin --match-head-commit <head-oid>`, `corepack pnpm ship:push -m "<subject>"`, `gh api user --jq .login`, `pnpm worktrees:prune --apply`. Minor gaps: PR creation is described ("Open one ready (not draft) PR") without an explicit command, and the validation step defers to `pnpm guards` selection rather than naming commands.

4 / 5

Workflow Clarity

A clear numbered sequence (Preflight → Validate/push → Open PR → Babysit → Merge gate → After merge) with explicit validation checkpoints: a merge-gate checklist held for 10 minutes on an unchanged head, OID verification recorded before merging, `--match-head-commit` protection, and feedback loops for CI failures and review threads (fix → reply → one batched push → re-check). The semi-irreversible merge operation has extensive validation, so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist; the single-file body (~130 lines) is well organized into numbered sections with clearly signaled references to sibling skills (/babysit-pr, /new-branch, /review-latest-feedback step 5). It exceeds the under-50-line simple-skill exception, and content like the worktree-rotation and throwaway-worktree pruning rules could arguably live in a reference file, placing it at good-structure-with-minor-gaps rather than fully appropriate splitting.

4 / 5

Total

17

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, comprehensive, third-person, and explicitly triggered with natural phrases. The only gaps are a few missing trigger synonyms and an undrawn boundary against sibling ship/monitor skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full pipeline — "Commit and push", "open a ready PR", "babysit it through CI and review", "admin-merge", "rotate the worktree" — matching the comprehensive-coverage anchor. It stays in third-person imperative voice with no vague padding, so it does not fall to the minor-gaps anchor at 4.

5 / 5

Completeness

It explicitly answers both "what" (commit, push, open PR, babysit CI/review, admin-merge, rotate worktree) and "when" ("Use when the user asks to ship, publish, or hand off local changes") with concrete trigger phrases, plus deployment consequences. The explicit trigger-based when-clause places it clearly at the top anchor, not 4.

5 / 5

Trigger Term Quality

"Use when the user asks to ship, publish, or hand off local changes" provides natural trigger terms users would actually say. It misses common synonyms such as "open a PR", "merge", or "land it", which keeps it at good-but-not-comprehensive coverage rather than the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The niche (full ship-through-merge pipeline) is distinct with clear triggers, but closely related skills exist in the same ecosystem (/ship-and-monitor, /babysit-pr) and the description does not draw that boundary itself. Minor overlap risk with closely related skills matches the 4 anchor rather than minimal-conflict 5.

4 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

BuilderIO/agent-native

Path

.agents/skills/ship/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.