CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-code-ship

This skill should be used when the user says "arness code ship", "arn-code-ship", or wants to commit, push, and optionally open a pull request. Guides through branching, staging, committing with meaningful messages, pushing, and PR creation. Works standalone or as the final Arness pipeline step. Do NOT use this for reviewing PRs — use /arn-code-review-pr for that.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

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.

A highly actionable, well-sequenced shipping workflow with executable commands, explicit user-facing messages, and robust validation/feedback loops. The main weaknesses are token efficiency (a redundant Error Handling recap, duplicated per-platform logic, and a compressible sketch-cleanup section) and room to push more detail (lint gate, sketch cleanup) into reference files.

Suggestions

Compress Step 5b's four sketch-status variants into a single table (status → message → available actions), which would cut roughly 35 lines while preserving all behavior.

Deduplicate the Error Handling section — either keep only failures not already handled inline (e.g., 'Bitbucket PR creation fails', 'PR already exists') or remove the inline duplicates, since most bullets restate step-level guidance verbatim.

Factor the shared PR title/body/CHANGE_RECORD-enrichment logic out of the separate GitHub and Bitbucket sections into one common block, and consider moving the Lint and Format Gate detail (sub-steps 3.1–3.6) into a reference file like feature-tracker-update.md.

DimensionReasoningScore

Conciseness

The body is dense and procedural with no padding or explanation of concepts Claude already knows, but it could be noticeably tightened: the ~20-line Error Handling section repeats items already specified inline (e.g., 'Git not available', 'Push rejected'), the GitHub and Bitbucket paths duplicate the same PR-body generation logic, and Step 5b's four status variants (~50 lines of near-identical Delete/Keep options) could be a compact table. This sits between anchors 3 and 4 — the redundancy is more than minor, so anchor 3 applies.

3 / 5

Actionability

Fully executable guidance throughout: copy-paste-ready commands (`git rev-parse --is-inside-work-tree`, `git log main..HEAD --oneline`, `gh label list --search "arness-"`, `bkt pr create --title "..." --source <branch> --destination <default-branch>`, the `git symbolic-ref ... | sed ...` default-branch detection), exact user-facing message templates, and numeric decision thresholds (N <= 20 → Fix now). Matches anchor 5's 'copy-paste ready commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Steps 1–6 are clearly sequenced with explicit validation checkpoints and feedback loops: the clean-tree/nothing-to-ship early exit, the sensitive-file warning before staging, the lint gate with N==0/N>0 branches and a fix-then-re-run-'arn-code-ship' recovery path, push-rejection handling with rebase suggestion, and per-failure-mode error handling (e.g., unauthenticated gh/bkt → suggest auth login and skip, Feature Tracker write failure → print table and do not fail the flow). Matches anchor 5's 'explicit validation steps; feedback loops for error recovery; checklists'.

5 / 5

Progressive Disclosure

Good structure with a genuine one-level-deep deferral: Step 6 points to `references/feature-tracker-update.md` (verified to exist and be self-contained, with no nested references). However, sizable inline detail — the lint-gate sub-steps, Step 5b's sketch-cleanup variants, and the duplicated per-platform PR logic — could also be split into reference files, and one pointer reaches into another skill's bundle (`arn-code-init/references/platform-labels.md`). Anchor 4's 'most content is appropriately placed; references mostly clear; minor organization gaps' is the best fit; not 5 because the split is not comprehensive.

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: it states what the skill does and when to use it with concrete trigger phrases in third-person voice, and adds useful boundary guidance by naming the skill it should NOT be used for. The only weaknesses are a few missing natural synonyms ('publish', 'submit', 'ship my changes') and mild overlap risk with generic commit/PR skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "Guides through branching, staging, committing with meaningful messages, pushing, and PR creation" — covering the entire shipping workflow comprehensively. It exceeds anchor 4 because there are no gaps in coverage of the workflow's actions, and anchor 5 is the best fit.

5 / 5

Completeness

Explicitly answers both 'what' (the branching/staging/committing/pushing/PR-creation workflow) and 'when' ("should be used when the user says ... or wants to commit, push, and optionally open a pull request"), with concrete trigger phrases and even a negative boundary ("Do NOT use this for reviewing PRs — use /arn-code-review-pr for that"). Matches anchor 5; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good keyword coverage: the literal triggers '"arness code ship", "arn-code-ship"' plus the natural phrases "wants to commit, push, and optionally open a pull request" and "PR creation". It falls short of anchor 5 because common synonyms users might say (e.g., 'publish changes', 'submit a PR', 'ship my code' without the arness phrasing) are missing.

4 / 5

Distinctiveness Conflict Risk

Distinct slash-command triggers and an explicit exclusion of the nearest neighbor skill (/arn-code-review-pr) give it a clear niche, but the generic trigger "wants to commit, push, and optionally open a pull request" could overlap with other git commit/PR skills. Mostly distinct with minor overlap risk — anchor 4 rather than 5, and clearly above anchor 3's 'could still overlap with similar skills'.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

AppsVortex/arness

Path

plugins/arn-code/skills/arn-code-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.