CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

linear

Load for any Linear read or write: issues, projects, cycles, milestones, initiatives, labels.

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Failed to scan

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./skills/linear/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is an information-dense operator manual with unusually concrete failure semantics and validation rules, but it reads as a wall of run-on prose that concentrates journal internals, governance policy, and per-option behavior in the top-level file. The dangling references to missing `patterns/` and `README.md` files are the clearest structural defect.

Suggestions

Add the referenced files (patterns/workflow-actions.md, README.md) to the bundle or remove/redirect the links — three links in the body currently point at files that do not exist, including the Quota Holds section that error handling depends on.

Move the Request journal section and Shared label maintenance into a reference file (e.g., references/journal.md, references/label-governance.md) and keep a 3-5 line pointer in SKILL.md, cutting roughly a third of the body.

Break the multi-clause run-on sentences (Issue Creation Routing, the `issues complete` bullet) into short imperative bullets or a numbered sequence so each rule is individually scannable and citable.

DimensionReasoningScore

Conciseness

The body wastes no tokens on concepts Claude already knows — it is packed with operational facts like "A quota refusal exits nonzero with JSON stderr `code:\"RATELIMITED\"`" — but at ~162 lines of dense run-on prose (the single-sentence Issue Creation Routing paragraph, the ~700-word `issues complete` bullet) much of it (journal internals, label governance, option minutiae) is overstuffed for a top-level SKILL.md and could be significantly tightened. Mostly earns its tokens but noticeably could be trimmed and split, matching anchor 3.

3 / 5

Actionability

Concrete, executable commands appear throughout — `linear.sh issues list --project "Phase 2" --state "Todo,In Progress" --max`, `auth-check --strict`, `comments bulk-list <ID1> <ID2> --stdin` — with exact refusal-line formats and exit-code semantics. Minor gaps keep it from anchor 5: common flows like a fully-flagged `issues create` example are never shown, and some guidance defers to external surfaces ("`linear.sh <resource> --help`", the project-management skill, `lane-mail peer send`).

4 / 5

Workflow Clarity

Multi-step flows carry real validation checkpoints: pre-write refusals ("Refused before any write" for option validation, cross-team guards, taxonomy checks), post-mutation verification ("`issues bulk-get` ... is also the post-mutation verification path"), label updates as fetch → compute → "validate it against `labels list --max --format=safe`" → pass the complete set, and error recovery for partial failures ("`partial: true` and exits non-zero"). It falls short of anchor 5 because sequences are dispersed through prose rather than presented as ordered workflows, and a few checkpoints are implicit (e.g., attachment fetch failure handling).

4 / 5

Progressive Disclosure

Section headers (## Commands, ## Reads, ## Attachments, ## Team Target) give real structure and the bundle genuinely splits code across `scripts/commands/` and `scripts/lib/`, but the body links to `patterns/workflow-actions.md`, `patterns/workflow-actions.md#quota-holds`, and `README.md#setup` — none of which exist in this bundle — and large chunks that belong in reference files (the ~40-line Request journal section, Shared label maintenance, Option Behavior detail) are inlined. This matches anchor 3: some structure, references present but flawed, content that should be separate is inline.

3 / 5

Total

14

/

20

Passed

Description

73%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 concise, well-triggered description that clearly signals when to load the skill and scopes it tightly to Linear resources. Its main weakness is that the "what" side relies on the generic verbs "read or write" plus a resource list, leaving the tool's actual capabilities (create, update, search, comment) to the separate summary field.

DimensionReasoningScore

Specificity

"Load for any Linear read or write: issues, projects, cycles, milestones, initiatives, labels" names the domain and six concrete resources, but the only actions offered are the generic pair "read or write" — no create, update, search, or comment verbs. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, which expects several specific listed actions.

3 / 5

Completeness

The description has an explicit trigger clause ("Load for any Linear read or write") answering "when", and "what" is present but thin — it implies handling reads/writes of the listed resources without saying what the skill actually is (a Bash CLI; that detail sits in the separate summary field). Both halves exist with one weaker, matching anchor 4 rather than 5, which requires a concrete statement of both.

4 / 5

Trigger Term Quality

"Linear", "issues", "projects", "cycles", "milestones", "initiatives", "labels", "read", "write" are natural terms users would say ("update the Linear issue", "list our Linear projects"). A few common variations are missing — "tickets", "comments", "assignee", "Linear app" — so it is good-but-not-comprehensive coverage (anchor 4), not the synonym-and-extension completeness of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"Linear" is a named product, so every trigger ("Linear issues", "Linear project", "Linear labels") is scoped to a clear niche with minimal overlap risk against generic project- or issue-tracking skills. This fits anchor 5 (clear niche with distinct triggers); at most a hypothetical second Linear skill would conflict, which the resource enumeration further disambiguates.

5 / 5

Total

16

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 5 missing

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

12

/

16

Passed

Repository

vanillagreencom/kendex

Path

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