CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

linear-agent-writes

The org policy for what an agent may write to Linear, and how it must be marked. Read this before creating a ticket, editing a description, or commenting on a ticket as an agent — "file this in Linear", "comment on the ticket", "create a subticket", "write the handover". Default those writes to a short human description; expand with research only when asked. Also covers the required Linear connection and what to do when there isn't one.

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 unusually actionable policy skill: every write shape has an exact label, an explicit propose-then-write sequence, and a failure path, and the batch sweep is gated by one human review instead of per-item asking. The main trimmable weight is the history/provenance rationale, and the one structural gap is any post-write check that the marking was applied as intended.

Suggestions

Condense the 'Why the taboo went away' section and the provenance note to a few lines (or move them to a reference file), keeping only the rules that change agent behavior.

Add a post-write verification step: after landing a write, confirm the Linear label and the in-text agent marking are both present, and re-check on the batch sweep report.

DimensionReasoningScore

Conciseness

The body is dense, imperative policy with no padding about concepts Claude already knows — every rule is org-specific. However, the multi-paragraph history section ('Why the taboo went away') and the provenance note are rationale that could be trimmed or relocated, which keeps it at 'minor instances of over-explanation' (4) rather than 'every token earns its place' (5).

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: exact labels (`AI commented`, `AI edited`, `AI created`), copy-paste ask wording, a literal no-connection reply template, wrong/right length examples, and a concrete batch-table spec. It is not 4 because the common cases (comment, description append, ticket create, sweep, no connection) are each covered with specific, ready-to-use guidance.

5 / 5

Workflow Clarity

Sequences are explicit for all three shapes (show the text, get a yes, then write), the sweep batch is gated by one table review with per-row go-aheads, and decline/no-answer and no-connection fallbacks are handled loudly. It falls short of 5 only because there is no post-write verification that the label and in-text marking actually landed; the batch path does include human validation, so the batch-cap at 3 does not apply.

4 / 5

Progressive Disclosure

Well-organized sections with one clearly signaled, one-level-deep reference to ../linear-context-handover/SKILL.md for handover-block details — good structure. It is not 5 because the file is ~215 lines with rationale/history inline that could live in a reference, and the single external pointer leaves the bulk policy monolithic relative to the 'clear overview' ideal.

4 / 5

Total

17

/

20

Passed

Description

91%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 the policy scope explicitly, gives copy-ready trigger phrases a user would actually say, and stays lean. Its only weakness is that the central propose-before-write rule is never named in the description itself, leaving a small gap between what the skill governs and what the description advertises.

DimensionReasoningScore

Specificity

Names several concrete actions — "creating a ticket, editing a description, or commenting on a ticket", "how it must be marked", the length default, and the Linear connection — with a minor gap: the core propose-then-write gate is only implied by 'Read this before', not stated. It sits between the 'several specific actions' (4) and 'comprehensive coverage' (5) anchors, closer to 4.

4 / 5

Completeness

Explicitly answers both parts: the 'what' ("The org policy for what an agent may write to Linear, and how it must be marked") and the 'when' ("Read this before creating a ticket, editing a description, or commenting on a ticket as an agent") with concrete trigger phrases quoted. Matches the top anchor exactly; not 4 because the 'when' is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrasing including synonyms: "file this in Linear", "comment on the ticket", "create a subticket", "write the handover", plus 'creating a ticket' and 'editing a description'. These are exactly the phrases a user would say; nothing natural is missing.

5 / 5

Distinctiveness Conflict Risk

A clearly distinct niche (agent write policy for Linear) with Linear-specific triggers, but "write the handover" overlaps with the closely related linear-context-handover skill, giving minor overlap risk. Mostly distinct, matching anchor 4 rather than the minimal-conflict 5.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

langfuse/langfuse

Path

.agents/skills/linear-agent-writes/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.