CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

implement-github-issue

Implement a GitHub issue that a person labelled `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

90%

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

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.

An exemplary instruction-only skill: terse, concrete, and validation-heavy, with an unambiguous prioritized situation tree, exact commands for every write, and strong feedback loops around failure and interruption. The only improvement areas are minor: provide a literal PR body template and consider splitting the invariants or PR-body spec into a reference file to slim the main file.

DimensionReasoningScore

Conciseness

The body teaches only skill-specific protocol: "Read the issue again before every write", "You push after every commit. A run can end at any moment", and exact commands like "git ls-remote --exit-code --heads origin tessl/<id>". No concept Claude already knows is explained, no section is padded, and every token carries operational weight, matching the lean anchor 5 rather than anchor 4 (which would still contain trimmable over-explanation).

5 / 5

Actionability

Nearly everything is copy-paste executable: "gh issue view <n> --json number,title,body,url,state,labels,assignees,author,comments", "gh pr create --base <base> --label tessl --title \"#<n>: <what the change does>\"", "git merge --no-ff origin/<base>", the literal started-work comment block, and the "tessl launch attach-link" invocation. It sits at anchor 4 rather than 5 only because a few pieces are described rather than templated: the PR body is specified as a contents list ("why the change exists and what it does; what you ran and saw") instead of a literal block, and test commands are deferred to AGENTS.md/CLAUDE.md/README.md.

4 / 5

Workflow Clarity

The "Situations" section is an ordered decision tree ("Read the record and take the first situation that applies") with explicit validation checkpoints and feedback loops: re-read the issue before every write, check the stop condition before every write, run tests again after merging the base, and on PR-creation failure "run `gh pr list --head <branch> --state open` before trying again". This matches anchor 5 (clear sequence, explicit validation, error-recovery loops) and exceeds anchor 4, where checkpoints would have gaps; the risky force-push case is also guarded with an explicit `--force-with-lease` recipe.

5 / 5

Progressive Disclosure

The skill is a single self-contained file with clear, well-ordered sections (inputs, GitHub, done-state, situations, invariants, doing the work, judgment) and no nested or buried references; the paths it names (`.cloud-launch/trigger-events.json`, `setup.sh`, `AGENTS.md`) are runtime inputs, clearly signaled. It fits anchor 4 (good structure, content appropriately placed, minor organization gaps) rather than 5 because at ~130 dense lines the one-level-deep reference pattern of anchor 5 is absent and sections such as the 11-item invariants list could plausibly live in a companion file for a leaner overview.

4 / 5

Total

18

/

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: concrete, third-person, tightly scoped action list with an explicit label-based trigger and stop condition, and no fluff or over-claims. The only soft spot is trigger coverage: a few natural user phrasings (fix/PR synonyms) are missing and distinctiveness leans heavily on the single `tessl` label.

DimensionReasoningScore

Specificity

"read the issue and the repository, make the change on the issue's own branch, run the tests, and open one pull request" names four concrete actions plus a concrete stop behavior ("Stops without a trace when a person has taken the issue back"), comprehensively covering the task with no vague filler. It clearly matches the anchor for multiple specific concrete actions and comprehensive coverage, not the level below ("several specific actions; minor gaps").

5 / 5

Completeness

The "what" is explicit and concrete (read issue and repo, change on the issue's own branch, run tests, open one PR) and the "when" is explicitly stated with a concrete trigger phrase: "a person labelled `tessl`", reinforced by the stop condition "when a person has taken the issue back". This matches anchor 5 (clearly and explicitly answers both what AND when with concrete trigger phrases) rather than anchor 4, where the when would be present but less explicit.

5 / 5

Trigger Term Quality

Natural terms a user would say are present: "GitHub issue", "implement", "branch", "run the tests", "open one pull request", plus the concrete label trigger "tessl". It falls at anchor 4 (good keyword coverage; a few natural terms missing) rather than 5 because common variations like "fix an issue", "close an issue", or "open a PR" are absent, and it is not comprehensive enough for the synonym-and-extension-level coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The `tessl` label gives this a clear niche with a distinct trigger, but the opening "Implement a GitHub issue" and "open one pull request" overlap with generic issue-implementation and PR-creation skills, leaving minor overlap risk with closely related skills. It fits anchor 4 better than 5 because the distinctness rests almost entirely on the label qualifier rather than wholly distinct trigger terms.

4 / 5

Total

18

/

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-github-issue/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.