CtrlK
BlogDocsLog inGet started
Tessl Logo

xtream-electron

IPTVnator's Electron-first Xtream implementation, including feature/data-access boundaries, worker-backed DB flows, and Xtream loading/progress UX.

55

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.codex/skills/xtream-electron/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

The body is a concise, well-organized reference with concrete paths and runnable test commands, but it functions as an architecture/navigation doc rather than an executable workflow, lacking sequenced steps and code examples for the Xtream operations it describes.

Suggestions

Add a short executable example or step-by-step sequence for a core Xtream operation (e.g., a worker-backed import) so the guidance instructs rather than only directs.

Provide an explicit workflow with validation checkpoints and a fix-and-retry loop for batch/destructive operations (large imports, delete, restore), referencing the test commands as the verification step.

Tie each Rule to the specific Key Area path it constrains so the architectural guidance is directly actionable in the named directories.

DimensionReasoningScore

Conciseness

The body is lean and well-assumed: short path lists, terse rules, and direct validation commands with no explanation of concepts Claude already knows, so every token earns its place.

3 / 3

Actionability

It gives concrete file paths and copy-paste validation commands, but the core work guidance ('import/search/delete behavior') is directive rather than executable, with no code example or specific implementation detail for those operations.

2 / 3

Workflow Clarity

A Validation section provides verification commands (a checkpoint), but there is no sequenced multi-step workflow or feedback loop for the batch/destructive operations the skill covers (large imports, global search, delete, restore).

2 / 3

Progressive Disclosure

The skill is under 50 lines with no external bundle files and is organized into clear, well-labeled sections (Key Areas, Rules, Validation), which satisfies the simple-skill criterion for progressive disclosure.

3 / 3

Total

10

/

12

Passed

Description

50%

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 is specific to a clear niche and names several concrete areas of the implementation, but it reads as internal architectural shorthand rather than user-facing trigger language and omits any explicit 'Use when...' guidance.

Suggestions

Add an explicit 'Use when...' clause naming the user situations that should activate this skill (e.g., 'Use when adding or debugging Xtream import, search, delete, or playback behavior in the Electron app').

Replace internal jargon ('worker-backed DB flows', 'feature/data-access boundaries') with natural terms users would say, and lead with concrete actions (import, search, delete, restore, play) rather than structural areas.

Include common keyword variations a user might mention (e.g., 'Xtream codes', 'IPTV playlist', 'Electron playback') to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ("Xtream implementation") and concrete areas ("feature/data-access boundaries, worker-backed DB flows, and Xtream loading/progress UX"), but these are components rather than concrete actions a user wants performed, so it is not comprehensive enough for a 3.

2 / 3

Completeness

It clearly states what the skill covers, but there is no "Use when..." clause or equivalent explicit trigger guidance, which per the guidelines caps completeness at 2.

2 / 3

Trigger Term Quality

Some natural terms a project user would say appear ("Xtream", "Electron", "IPTVnator"), but the phrase is padded with internal jargon like "worker-backed DB flows" and "feature/data-access boundaries" that users would not naturally utter.

2 / 3

Distinctiveness Conflict Risk

The niche (IPTVnator's Electron Xtream implementation) is fairly specific, but without explicit trigger phrasing it could still overlap with general Electron or IPTV work, so it does not reach a clear, conflict-free 3.

2 / 3

Total

8

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
4gray/iptvnator
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.