CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fix-issue

End-to-end flow for resolving a GitHub issue — fetch and understand the issue, create a feature branch off `beta`, implement and verify the fix, then hand off to the open-pr skill. Use when the user says "fix issue <n>", "work on issue <n>", or wants to take an issue from investigation through to a PR.

77

Quality

97%

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

100%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 workflow skill body: a tight four-phase sequence with concrete commands, explicit error-path handling (diverged base, missing dependencies, invalid issues), validation checkpoints, and clear ownership boundaries delegated to open-pr. It is lean, actionable, and well organized with no padding or redundant explanation.

DimensionReasoningScore

Conciseness

Roughly 35 lean lines where every instruction is actionable; it explains nothing Claude already knows, and the one explanatory parenthetical ('Plain `gh issue view <n>` may fail on Projects-classic GraphQL — prefer the `--json` form') is non-obvious, earned knowledge — matching the 'every token earns its place' anchor.

5 / 5

Actionability

Provides copy-paste-ready commands (`gh issue view <n> --json title,body,state,labels,comments,author,createdAt` and the full `git checkout <base> && git pull --ff-only && git checkout -b <type>/<n>-<short-slug> <base>` sequence) plus a concrete branch-name example (fix/2348-dts-in-source); the implement phase's absence of code is inherent to the task and its guidance remains concrete.

5 / 5

Workflow Clarity

Four clearly sequenced phases (understand → branch → implement → hand off) with explicit validation checkpoints: confirm the approach before behavior-changing edits, stop and surface on `--ff-only` failure, run tests/typecheck with honest reporting when dependencies are absent, and explicit regression reasoning. Matches the anchor-5 sequence-with-validation pattern; no destructive/batch cap applies.

5 / 5

Progressive Disclosure

Under 50 lines with no external reference material needed, so a single well-organized file with numbered sections is the correct structure per the rubric's simple-skill note; cross-mentions (open-pr, verify, code-review) are skill invocations that clarify ownership, not buried file references.

5 / 5

Total

20

/

20

Passed

Description

92%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: it states a concrete, phased capability set, gives explicit third-person 'Use when...' trigger guidance with natural phrasings, and cleanly separates its scope from the adjacent open-pr skill. The only gap is modest synonym coverage in its trigger terms.

DimensionReasoningScore

Specificity

Lists four concrete actions covering the full flow — 'fetch and understand the issue, create a feature branch off `beta`, implement and verify the fix, then hand off to the open-pr skill' — with specifics beyond the anchor-4 example (named base branch, named handoff skill), matching the comprehensive anchor 5.

5 / 5

Completeness

Explicitly answers both 'what' (all four end-to-end phases) and 'when' with a concrete 'Use when the user says...' clause listing exact trigger phrases — a direct match for the anchor-5 example, clearly above anchor 4 whose 'when' is less specific.

5 / 5

Trigger Term Quality

Includes natural quoted trigger phrases users would say ('fix issue <n>', 'work on issue <n>', 'take an issue from investigation through to a PR') with good keyword coverage, but misses common variations such as 'resolve/close/address issue' or issue-URL phrasing, so it falls short of the synonym-saturated anchor 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (GitHub issue resolution workflow) with distinct command-shaped triggers; the explicit 'hand off to the open-pr skill' clause delineates the boundary with the most closely related skill, minimizing conflict risk.

5 / 5

Total

19

/

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

analogjs/analog

Path

.agents/skills/fix-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.