CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

linear-tickets

Create or update high-quality Linear tickets while preserving the originating report, diagnostic links, attachments, and reporter/requester attribution. Read this whenever someone asks to create, recreate, or update a Linear issue.

Quality

95%

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

92%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.

A tight, well-structured instruction skill: a complete before/create/verify workflow with an explicit post-write validation checklist and fix loop, and no wasted tokens. Its only weakness is mild genericity around tool selection — it says to use the configured Linear MCP tools without naming them or giving an example ticket — which keeps actionability at 4.

DimensionReasoningScore

Conciseness

Lean and efficient throughout — every line is directive ("Write a concise, specific title.", "Never fabricate a URL, identity, field value, or technical detail.") with zero concept explanations or padding, fully assuming Claude's competence. Anchor 5 fits; there is no over-explanation to justify dropping to 4.

5 / 5

Actionability

Mostly concrete and executable for an instruction-only skill: an enumerated capture checklist (reporter identity, reproduction details, expected/actual behavior, diagnostic URLs, attachments), a preferred description section order, and a specific verification list. It falls short of anchor 5 only because tools are referenced generically ("Use the configured Linear MCP tools") without naming any, and no example title/description is provided; it is well above anchor 3's pseudocode-level vagueness.

4 / 5

Workflow Clarity

Clear three-phase sequence (Before writing → Create or update → Verify) with an explicit verification checklist ("title and description reflect the request… source links remain present… reporter/requester attribution is retained") and a feedback loop ("Fix omissions before reporting completion"). This matches anchor 5's explicit validation and error-recovery pattern; it is not 4 because checkpoints and the fix-before-complete loop are fully present, and no destructive/batch cap applies.

5 / 5

Progressive Disclosure

A single-file, ~50-line skill with well-organized sections, no bundle files, no inlined content that belongs in a separate file, and no dangling references. Per the rubric's simple-skill note, well-organized sections alone merit 5 when no external references are needed.

5 / 5

Total

19

/

20

Passed

Description

95%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: third-person, concise, and specific about both capabilities and the artifact-preservation guarantees, with an explicit "Read this whenever…" trigger clause covering create/recreate/update and both "ticket" and "issue" synonyms. The only minor gap is that some ticket fields it handles (labels, priority, status) are absent from the capability list, capping specificity at 4.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Create or update high-quality Linear tickets" plus preserving "diagnostic links, attachments, and reporter/requester attribution" — with only minor coverage gaps (e.g., labels/priority handling not mentioned). It exceeds the 1-2-action anchor but is not comprehensively complete, so anchor 4 fits best.

4 / 5

Completeness

Explicitly answers both: what ("Create or update high-quality Linear tickets while preserving the originating report, diagnostic links, attachments, and reporter/requester attribution") and when ("Read this whenever someone asks to create, recreate, or update a Linear issue") with concrete trigger phrases. This matches the anchor-5 pattern exactly; it is not 4 because the when-clause is already explicit and trigger-phrased.

5 / 5

Trigger Term Quality

Natural trigger coverage includes "Linear tickets", "Linear issue", and the verbs "create, recreate, or update" — the product name plus noun and verb synonyms users would actually say. Coverage density matches the anchor-5 example's synonym spread; only marginal variants like "file/open a ticket" are absent and "create" captures that intent.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Linear ticketing) with product-specific triggers ("Linear tickets", "Linear issue") that no generic competing skill would match, giving minimal conflict risk. Anchor 5 applies; it is not 4 since no meaningful overlap with related skills exists.

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

langchain-ai/open-swe

Path

openswe/bundled_skills/linear-tickets/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.