Content
96%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exceptionally tight, operational skill body: concrete commands throughout, explicit validation checkpoints with re-read-before-write and retry loops, and zero filler. The only structural blemish is the dangling frontmatter reference to a missing schemas/inputs.schema.json file.
Suggestions
Ship the referenced ./schemas/inputs.schema.json in the bundle or drop the frontmatter $ref — as written it points at a file that does not exist.
Consider moving the Linear- and GitHub-specific 'Environment facts' into one-level-deep reference files so the core workflow reads shorter.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence carries system-specific operational fact Claude cannot know — 'tessl launch list --link-type ... --json', the '<!-- tessl-factory -->' markers, Linear's delayed state reads, exact branch naming ('tessl/<identifier lowercased>') — with no padding and no explanation of concepts Claude already knows. It matches 'lean and efficient; every token earns its place'. | 5 / 5 |
Actionability | Copy-paste-ready commands cover the common cases: the tessl launch list/cancel commands, the full gh command set, the jq label extraction, the GitHub search query, verbatim comment bodies, GraphQL mutation shapes ('issueUpdate(id, input: {stateId})', 'commentCreate(input: {issueId, body})'), and the endpoint/auth header. The only gaps (Linear read queries, team-state lookup) are minor and derivable from the given shapes. | 5 / 5 |
Workflow Clarity | The workflow has an explicit stop-condition checklist ('Stop with no write and say what was wrong when:...'), first-match situation ordering per TICKET_CHANGE, re-read-before-write checkpoints ('Read the issue and the pull request again. If the issue is still ended and the pull request still open...'), a stale-read feedback loop ('read it again, up to five times, 10 to 30 seconds apart'), and per-failure handling including a retry-once rule. This matches 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists'. | 5 / 5 |
Progressive Disclosure | There are no bundle files (no references/, scripts/, or assets/), and the single-file structure with well-labeled sections (inputs, per-change sections, Unblocking, Invariants, Environment facts, Judgment) is defensible since one run needs all of them. It falls short of the top anchor because the frontmatter's '$ref: ./schemas/inputs.schema.json' points to a file that does not exist in the bundle, and the ~220-line body is at the edge where per-tracker environment details could live in separate reference files. | 4 / 5 |
Total | 19 / 20 Passed |