Name: jetbrains-youtrack
Rating: 58.4 (1 reviews)
Author: membranedev

jetbrains-youtrack

JetBrains YouTrack integration. Manage data, records, and automate workflows. Use when the user wants to interact with JetBrains YouTrack data.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/jetbrains-youtrack/SKILL.md

Quality

Content

75%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 highly actionable with copy-paste commands and a clear connection workflow including state-based feedback loops. Its main weakness is conciseness — a few introductory and marketing sentences could be cut — plus a dangling "Step 2" reference that slightly muddies the workflow.

Suggestions

Remove the introductory "JetBrains YouTrack is a project management..." sentence and the "so you can focus on the integration logic" padding; Claude already knows this.

Fix the dangling "skip to Step 2" reference by labeling the subsequent section (e.g. "## Step 2: Search and run actions") so the workflow is unambiguous.

Add a brief verify step after `membrane action run` (e.g. check the `output` field / response status) to close the loop on potentially destructive actions.

Dimension	Reasoning	Score
Conciseness	The body is mostly command-driven and efficient, but includes unnecessary explanation Claude already knows ("JetBrains YouTrack is a project management and issue tracking tool...") and light marketing padding ("so you can focus on the integration logic rather than auth plumbing"). Not 4 because several sentences could be trimmed, not 2 because the bulk is concrete commands rather than padded prose.	3 / 5
Actionability	Commands are fully executable and copy-paste ready across the common cases — install (`npm install -g @membranehq/cli@latest`), login, `connection ensure`, `action run`, and `request` with a complete flag table. Matches the anchor for copy-paste ready commands covering common cases.	5 / 5
Workflow Clarity	There is a clear install → auth → connect → search → run sequence with explicit state checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a poll → handle → re-poll feedback loop. Not 5 because the "skip to Step 2" reference points to a Step 2 that is never labeled, leaving a minor navigation gap.	4 / 5
Progressive Disclosure	The single file is well-organized with clear section headers and no nested references, and a CLI usage guide reasonably keeps its content inline. Not 5 because at ~140 lines with no external references, content like the proxy options table and best practices could be split out; not 3 because structure and navigation are solid.	4 / 5
	Total	16 / 20 Passed

Description

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

The description has a clear niche and an explicit trigger clause, but its capability list is generic ("manage data, records, and automate workflows") rather than naming concrete YouTrack actions. Tightening the action verbs would lift specificity and completeness.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete YouTrack actions such as "create and update issues, add comments, manage projects and tags".

Add natural trigger synonyms users actually say, e.g. "Use when the user wants to create or update YouTrack issues, comments, or projects."

Mention the REST API proxy capability explicitly so the description reflects the body's main features.

Dimension	Reasoning	Score
Specificity	The description names the domain ("JetBrains YouTrack integration") but its actions are generic — "Manage data, records, and automate workflows" — rather than concrete operations like creating issues or managing projects. It sits below 3 because no specific concrete action is enumerated, and above 1 because the domain is clearly named.	2 / 5
Completeness	Both "what" ("Manage data, records, and automate workflows") and "when" ("Use when the user wants to interact with JetBrains YouTrack data") are present, with the trigger fairly explicit. Not 5 because the "what" is generic rather than concrete, not 3 because an explicit trigger clause exists.	4 / 5
Trigger Term Quality	"Use when the user wants to interact with JetBrains YouTrack data" is a natural phrase, but the only real keyword is the product name repeated; common synonyms like "issues", "tickets", or "projects" are missing. Not 4 because coverage of natural variations is thin, not 2 because the trigger phrase is genuinely natural.	3 / 5
Distinctiveness Conflict Risk	Naming JetBrains YouTrack specifically carves out a clear niche with a distinct, product-specific trigger, giving minimal overlap risk with other skills. It clearly matches the anchor for a clear niche with minimal conflict.	5 / 5
	Total	14 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: membranedev/application-skills
Path: skills/jetbrains-youtrack/SKILL.md
Commit: f484c82

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.