CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

implement-linear

Implement a Linear issue that a person delegated to Tessl: read the issue and the repository, make the change on the issue's own branch, run the tests, and open one pull request for the issue. Stops without a trace when a person has taken the issue back.

Quality

88%

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

The canonical home for this skill is tessl-labs/factory

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 tight, fully actionable operating procedure: exact commands, explicit sequencing, validation before every write, and error-recovery loops, with no filler. The only structural gap is that everything lives inline in one file; a reference file for the GraphQL field schema would lighten the main body.

DimensionReasoningScore

Conciseness

The body is lean and operational throughout: it never explains concepts Claude already knows and spends every line on system-specific rules ("Never call api.linear.app directly", exact env vars, marker comments). Nothing reads as padding, so it matches the 'every token earns its place' anchor rather than the 'minor instances of over-explanation' anchor at 4.

5 / 5

Actionability

Guidance is fully executable: a copy-paste curl wrapper for the GraphQL endpoint, an exact GraphQL field list with pagination instructions, concrete git and gh commands ("git ls-remote --exit-code --heads origin tessl/<id>", "gh pr create --base <base> --label tessl ... --body-file <file outside the clone>"), and verbatim comment templates. The remaining placeholders are deliberate variables, not gaps, which keeps it above the 'minor gaps' anchor at 4.

5 / 5

Workflow Clarity

The process is explicitly sequenced ("Read the record and take the first situation that applies") with a done-checklist, validation checkpoints (re-read the issue before every write, check situation 1 before every write, re-run tests after merging the base), and error-recovery loops ("If it fails or prints no URL, run gh pr list --head <branch> --state open before trying again"; failed setup.sh escalates to situation 4). Destructive-adjacent operations all carry validation (force-push only with --force-with-lease=<branch>:<head you read>), so the cap-3 rule for unvalidated destructive workflows does not apply.

5 / 5

Progressive Disclosure

Sections are clear and easy to navigate (inputs, Linear, finished state, situations, invariants, doing the work, judgment), but it is a ~150-line single file with no bundle files and no content split out, so it fits 'good structure; most content appropriately placed; minor organization gaps' rather than the 5 anchor, which expects well-signaled one-level-deep references. The under-50-line simple-skill exception does not apply at this length.

4 / 5

Total

19

/

20

Passed

Description

75%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 specific, distinctive description that concretely covers the whole implement-and-PR workflow plus its stop condition. Its one weakness is trigger guidance: the 'when' is only implied by the delegation qualifier rather than stated as an explicit 'Use when...' clause, which both caps completeness and leaves natural trigger phrasings implicit.

Suggestions

Add an explicit trigger clause, e.g. "Use when a Linear issue has been delegated to Tessl and needs implementation, branching, testing, or a pull request."

Include the natural phrases a person would actually say when invoking this skill ("implement this Linear issue", "work on the delegated issue", "open a PR for the issue") so trigger matching does not rely on the qualifier alone.

Name the trigger inputs once in the description (Linear webhook/delegation event), since the body shows the skill is event-driven but the description never says what fires it.

DimensionReasoningScore

Specificity

It lists the full concrete action chain ("read the issue and the repository, make the change on the issue's own branch, run the tests, and open one pull request for the issue") plus a stop condition ("Stops without a trace when a person has taken the issue back"). This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); the 4 anchor requires minor coverage gaps, and there are none for this workflow.

5 / 5

Completeness

The 'what' is explicit and concrete, but there is no 'Use when...' clause or equivalent standalone trigger sentence; the 'when' exists only as the embedded qualifier "that a person delegated to Tessl", which makes it weakly implied. Per the judging guideline, a missing explicit trigger clause caps completeness at 3, so it does not reach the 4 anchor's 'has both what and when'.

3 / 5

Trigger Term Quality

Good natural keywords are present ("Linear issue", "delegated", "branch", "run the tests", "pull request") that a user would plausibly say, but there is no synonym-level coverage of the trigger space. This fits the 4 anchor (good keyword coverage, a few natural terms missing) rather than the 5 anchor (comprehensive coverage including synonyms and extensions).

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Linear issues delegated to Tessl) with distinctive trigger terms unlikely to collide with any generic skill. This matches the 5 anchor (clear niche with distinct triggers, minimal conflict risk) rather than the 4 anchor's 'minor overlap risk with closely related skills'.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

fkukuck/fabro

Path

.tessl/plugins/tessl-labs/factory/skills/implement-linear/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.