Content
88%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.
A strong, highly actionable procedural skill: exact commands, verbatim prompts, and validation feedback loops throughout a nine-step workflow. Its weaknesses are two overloaded run-on paragraphs that could be tightened, and two orphaned bundle files that break otherwise clean navigation.
Suggestions
Break the giant conditional paragraphs in step 2.8 and step 7.6 into bulleted if/then rules (or move the Code Review approval and doctor-message handling into a reference file) so each rule is scannable instead of embedded in a run-on block.
Link references/linear.md and references/triggers.md from SKILL.md (e.g., in step 3 where Linear connections and triggers are discussed), so every bundle file is reachable from the overview.
Resolve or guard the ../prepare-repo/SKILL.md link in step 9 — it does not exist in this bundle, so state the expected sibling-skill layout or make the offer conditional on the skill being installed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and free of explanations of concepts Claude already knows, but step 2.8 and step 7.6 each pack a dozen-plus conditionals into single run-on paragraphs, and warnings repeat (e.g., "Do not retry or work around the refusal" appears in both step 8.1 and 8.2). Not 5: these sections could be tightened or tabulated without losing operational content; not 3: there is no genuinely unnecessary explanation — every rule is Tessl-specific edge-case handling. | 4 / 5 |
Actionability | Guidance is fully executable: exact commands with flags ("tessl project repair --json", "gh repo view --json isFork,parent"), exact JSON fields to read ("linkedProject.workspaceName", "repository.attentionReason"), branch-name conventions, and verbatim questions to ask the user. Not 4: no gaps — common cases (fork, no tessl.json, uncommitted changes, missing app install) each have a specific prescribed response. | 5 / 5 |
Workflow Clarity | Nine clearly sequenced steps with explicit validation checkpoints and feedback loops: re-run doctor after fixes, re-check the GitHub App after the user installs it, verify the remote tessl.json "reflects the whole submitted change" before going live, run the setup hook twice in a fresh clone, and "[confirm the Loops appear]" before declaring setup finished. Destructive actions (push, merge) are gated on explicit user consent, and refusals have prescribed fallbacks. | 5 / 5 |
Progressive Disclosure | The body is a well-organized overview with clearly signaled one-level-deep references (starters, progress, testing, setup-hook, cli-version, links, customize, confirm-loops), all of which exist as real files. Not 5: references/linear.md and references/triggers.md exist in the bundle but are never linked from SKILL.md (linear is only hinted at via a command, not the file), and the ../prepare-repo/SKILL.md link does not resolve within this bundle — minor navigation gaps. | 4 / 5 |
Total | 18 / 20 Passed |