CtrlK
BlogDocsLog inGet started
Tessl Logo

linear-automation

Automate Linear tasks via Rube MCP (Composio): issues, projects, cycles, teams, labels. Always search tools first for current schemas.

63

1.97x
Quality

45%

Does it follow best practices?

Impact

95%

1.97x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.trae/skills/linear-automation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description identifies a clear niche (Linear automation via Composio) and lists relevant entity types, giving it good distinctiveness. However, it lacks specific action verbs describing what can be done, misses common user trigger terms, and has no explicit 'Use when...' guidance, which significantly weakens its ability to be selected appropriately from a large skill set.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about Linear tickets, project tracking, sprint planning, or task management in Linear.'

Replace the vague 'Automate Linear tasks' with specific actions like 'Create, update, and search Linear issues; manage projects and cycles; assign labels and team members.'

Include natural user trigger terms like 'ticket', 'bug', 'sprint', 'backlog', 'task tracking' that users would commonly say when needing this skill.

DimensionReasoningScore

Specificity

Names the domain (Linear) and lists entity types (issues, projects, cycles, teams, labels) but doesn't describe specific concrete actions like 'create issues', 'assign labels', 'manage cycles'. The verb 'automate' is somewhat vague.

2 / 3

Completeness

Describes what it does (automate Linear tasks) but has no explicit 'Use when...' clause or equivalent trigger guidance. The instruction to 'always search tools first' is an implementation detail, not a trigger condition. Per rubric guidelines, missing 'Use when' caps completeness at 2, and the 'what' is also only partially specified, warranting a 1.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'Linear', 'issues', 'projects', 'cycles', 'teams', 'labels', and 'Composio', but misses common user phrasings like 'create ticket', 'assign issue', 'track project', 'sprint', or 'backlog'. The term 'Rube MCP' is technical jargon unlikely to be used by users.

2 / 3

Distinctiveness Conflict Risk

The combination of 'Linear', 'Rube MCP', and 'Composio' creates a very clear niche. It's unlikely to conflict with other skills since it targets a specific project management tool through a specific integration pathway.

3 / 3

Total

8

/

12

Passed

Implementation

50%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides a comprehensive catalog of Linear operations via Rube MCP with clear tool naming and parameter documentation. Its main weaknesses are redundancy across sections, lack of concrete executable examples showing actual tool invocations with real parameters, and missing validation/error-handling steps in workflows. The content would benefit from being more concise and including at least one fully worked example.

Suggestions

Add at least one complete worked example showing an actual RUBE_SEARCH_TOOLS call followed by a LINEAR_CREATE_LINEAR_ISSUE call with concrete parameters and expected response structure.

Remove duplicate information — priority values and team scoping advice appear in multiple places; consolidate into the Known Pitfalls or Quick Reference section only.

Add validation checkpoints to core workflows (e.g., 'Verify the response contains the created issue ID before proceeding to update it') to handle failures gracefully.

Consider splitting the detailed workflow sections into a separate reference file and keeping SKILL.md as a concise overview with the setup, quick reference table, and known pitfalls.

DimensionReasoningScore

Conciseness

The skill is reasonably structured but contains redundancy — priority values are listed twice (in Manage Issues and Known Pitfalls), team scoping advice is repeated multiple times, and the ID Resolution patterns are somewhat obvious given the tool names. The quick reference table duplicates information already covered in the workflows. Some trimming would improve token efficiency.

2 / 3

Actionability

The skill provides tool names, parameter lists, and sequences, but lacks executable examples — the ID resolution patterns use pseudocode-style numbered lists rather than actual MCP call examples with concrete parameters. There are no copy-paste-ready tool invocations showing exact input/output shapes, and the instruction to 'always call RUBE_SEARCH_TOOLS first' doesn't show what that call looks like.

2 / 3

Workflow Clarity

Multi-step workflows are listed with clear sequences and prerequisite annotations, which is good. However, there are no validation checkpoints — no steps to verify an issue was created successfully, no error handling guidance if a tool call fails, and no feedback loops for recovery. The setup section has a reasonable verification flow but the core workflows lack these checks.

2 / 3

Progressive Disclosure

The content is organized into logical sections with a table of contents-like structure, but it's all inline in one file with significant length. The quick reference table at the end is useful but the detailed workflow sections could benefit from being split into separate files. The external link to Composio docs is good but there's no clear signaling of what additional detail lives there versus what's covered here.

2 / 3

Total

8

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
Lingjie-chen/MT5
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.