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 ./plugins/all-skills/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 Rube MCP/Composio) with good distinctiveness, but lacks explicit trigger guidance ('Use when...') and specific concrete actions. The entity types listed (issues, projects, cycles) provide some specificity but don't describe what operations can be performed on them.

Suggestions

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

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 common user-facing synonyms like 'ticket', 'task', 'sprint', 'backlog', and 'project management' to improve trigger term coverage.

DimensionReasoningScore

Specificity

Names the domain (Linear tasks via Rube MCP/Composio) and lists entity types (issues, projects, cycles, teams, labels), but doesn't describe specific concrete actions like 'create issues', 'assign labels', or 'manage cycles'. The word '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 operational guidance, not a trigger condition. Per rubric, missing 'Use when' should cap completeness at 2, and the 'what' is also only partially specified, so this scores a 1.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'Linear', 'issues', 'projects', 'cycles', 'teams', 'labels', 'Composio', and 'Rube MCP', but misses common user variations like 'ticket', 'task', 'sprint', 'backlog', or 'project management'. Users may not naturally say 'Rube MCP' or 'Composio'.

2 / 3

Distinctiveness Conflict Risk

The combination of 'Linear', 'Rube MCP', and 'Composio' creates a very specific niche that is unlikely to conflict with other skills. The tool and platform references are highly distinctive.

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 solid structural overview of Linear automation via Rube MCP with clear tool names, parameter lists, and workflow sequences. Its main weaknesses are redundancy across sections (priority values, team scoping advice repeated), lack of concrete executable examples showing actual tool invocations with sample payloads/responses, and missing validation/error-recovery steps in workflows. The content would benefit from being more concise and including at least one end-to-end worked example.

Suggestions

Add at least one concrete end-to-end example showing actual tool call parameters and expected response structure (e.g., creating an issue from scratch with real sample payloads)

Remove duplicated information — priority values and team scoping advice appear in multiple places; consolidate into a single reference

Add validation/error-recovery steps to core workflows (e.g., 'Verify issue was created by checking the returned issue ID', 'If creation fails due to invalid state_id, re-fetch states')

Consider splitting detailed workflow sections into separate referenced files, keeping SKILL.md as a concise overview with the quick reference table and setup instructions

DimensionReasoningScore

Conciseness

The skill is reasonably organized but has notable redundancy: priority values are listed twice (in Manage Issues and Known Pitfalls), team scoping advice is repeated multiple times, and the quick reference table largely duplicates information already covered in the workflow sections. Some sections like 'Common Patterns' for ID resolution are obvious patterns Claude could infer.

2 / 3

Actionability

The skill provides specific tool names, parameter lists, and tool sequences, which is helpful. However, there are no executable code examples or concrete input/output examples showing actual tool calls with real payloads. The ID resolution patterns use pseudocode-style numbered lists rather than actual tool invocation examples with sample parameters and responses.

2 / 3

Workflow Clarity

Workflows are clearly sequenced with labeled steps and prerequisite annotations, which is good. However, there are no validation checkpoints or error recovery steps — e.g., no guidance on what to do if issue creation fails, how to verify an issue was created correctly, or how to handle auth token expiration. The setup section has a basic verification flow but core workflows lack feedback loops.

2 / 3

Progressive Disclosure

The content is well-structured with clear headers and sections, but it's a monolithic file with no bundle files to offload detailed content. The quick reference table, all five workflow sections, and common patterns could benefit from being split — the detailed workflow sections could be in separate files with the SKILL.md serving as a concise overview. The external link to Composio docs is helpful but insufficient for progressive disclosure.

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
davepoon/buildwithclaude
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.