CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ship-ticket

Ship a GitHub issue that a person labelled for Tessl the Perihelion way: read the issue and the repository, plan it with the plan skill when it needs a design, build it test-first with the build skill on the issue's own branch, and open one pull request for the issue. Stops without a trace when a person has taken the issue back.

Quality

85%

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

88%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.

This is a dense, highly operational orchestration skill: exact commands, literal templates, prioritized decision rules, and validation checkpoints throughout, with essentially no token waste or explanation of things Claude already knows. Its only structural weakness is that everything lives in one long file with some deliberate-looking but mild redundancy across sections.

DimensionReasoningScore

Conciseness

The body is telegraphic and assumes Claude's competence: no basic concepts are explained, and every section carries operational rules rather than padding. A few spots could still be tightened, such as 'Each round is a fresh agent with no memory of the last, so the issue, the branch and the pull request are the only record' and slight redundancy between 'What done looks like' item 2 and invariant 5 ('one branch per issue, one open PR per issue').

4 / 5

Actionability

Guidance is copy-paste ready throughout: exact commands with flags ('gh issue view <n> --json number,title,body,url,state,labels,assignees,author,comments', 'git ls-remote --exit-code --heads origin tessl/<id>', 'gh pr create --base <base> --label tessl --title ...'), exact comment templates with literal marker strings, and defined placeholders (<n>, <id>, <base>).

5 / 5

Workflow Clarity

The multi-step process is explicitly sequenced: a prioritized situation list, the Canonical Workflow (plan, then build), and the ordered 'Doing the work' steps (base, branch, setup, tests, before the PR, PR, link). Validation checkpoints are explicit and repeated: 'Read it again before every write', 'run it and see it fail for the reason you expect', re-running tests after merging the base, and the error-recovery loop of 'gh pr list --head <branch> --state open' before retrying a failed 'gh pr create'.

5 / 5

Progressive Disclosure

The body is well sectioned with clear headers (inputs, situations, invariants, workflow, doing the work, judgment) and no buried or nested references, but it is a ~170-line monolith with no bundle files: the skill exceeds the 50-line threshold at which well-organized sections alone earn a 5, and minor cross-section overlap (done-state vs invariants) leaves small organization gaps.

4 / 5

Total

18

/

20

Passed

Description

76%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.

The description is concrete, third-person in style, and covers the whole workflow with an identifiable trigger condition and near-zero conflict risk. Its weaknesses are the absence of an explicit 'Use when...' phrasing and missing natural synonyms a user would say when handing over work, plus a small amount of internal jargon ('the Perihelion way').

Suggestions

Add an explicit trigger clause, e.g. 'Use when a GitHub issue carries the Tessl trigger label or someone asks Tessl to take over an issue.'

Include natural user phrasings as trigger terms, such as 'ticket', 'implement this issue', 'take this issue', or 'fix this issue', so the description matches how users actually ask.

Drop or define the buzzword phrase 'the Perihelion way'; it adds no capability information and reads as fluff to anyone outside the team.

DimensionReasoningScore

Specificity

Multiple specific concrete actions cover the full lifecycle: 'read the issue and the repository, plan it with the plan skill when it needs a design, build it test-first with the build skill on the issue's own branch, and open one pull request for the issue', plus the stop condition 'Stops without a trace when a person has taken the issue back'. The only fluff is 'the Perihelion way', which is minor against otherwise comprehensive coverage.

5 / 5

Completeness

The 'what' is explicit and concrete (read, plan, build test-first, open one PR). A 'when' is present via the equivalent trigger condition 'a GitHub issue that a person labelled for Tessl', but it is woven into the object description rather than stated as an explicit 'Use when...' clause, so it could be more explicit. Not score 3 because explicit trigger guidance (the label) does exist; not 5 because there is no clearly phrased invocation trigger.

4 / 5

Trigger Term Quality

Relevant domain keywords are present ('GitHub issue', 'pull request', 'branch', 'label', 'test-first'), but common natural variations are missing: a user handing work over would say 'ticket', 'implement this issue', 'take this issue', or 'fix this', none of which appear. 'Tessl' and 'the Perihelion way' are internal jargon rather than terms a user naturally says.

3 / 5

Distinctiveness Conflict Risk

A clear niche with distinct triggers: only issues labelled for Tessl, a fixed branch convention ('tessl/<id>'), specific marker comments ('tessl-factory'), and delegation to named sibling skills (plan, build). Minimal realistic overlap with generic issue or PR skills.

5 / 5

Total

17

/

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

perihelionhq/perihelion-platform-context

Path

plugins/canonical-workflow/skills/ship-ticket/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.