CtrlK
BlogDocsLog inGet started
Tessl Logo

tessleng/skill-inventory

Understand a skill inventory and address its findings for the current repo

76

Quality

96%

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

Overview
Quality
Evals
Security
Files

Quality

Content

100%Weight 40%Scale 1-3

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

An efficient, well-structured instruction skill that delegates API mechanics outward, provides concrete remediation commands per archetype, and sequences its workflow with a validation checkpoint. It is a strong example of token-disciplined, actionable skill content.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence, explicitly delegating API mechanics to the tessl/api skill ('Never restate endpoint schemas or read openapi.json here') rather than restating them. No basic-concept padding; archetype remediations are terse. A mild double-listing of resolved evidence fields is the only redundancy and does not rise to verbosity.

3 / 3

Actionability

Gives concrete, executable commands for every archetype (tessl install, tessl update, tessl skill publish, tessl api with status=active) and grounds fixes in actual returned fields (body, frontmatter, path). Exact endpoint invocation is deliberately deferred to tessl/api search/show, which is an appropriately justified design choice.

3 / 3

Workflow Clarity

A clearly sequenced four-step workflow with priority ordering (critical>high>medium>low), pagination handling, and an explicit re-fetch validation checkpoint confirming findings move to resolved. The verification step is present rather than missing, so it is not capped at 2; error-recovery detail is light but the validation feedback loop exists.

3 / 3

Progressive Disclosure

A single self-contained SKILL.md organized into clear sections (overview, API discovery, workflow, remediation by archetype), with API detail one level deep in the clearly-signaled tessl/api plugin rather than inlined. No bundle files exist, and nothing here warrants a separate file.

3 / 3

Total

12

/

12

Passed

Description

90%Weight 40%Scale 1-3

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, well-scoped description that pairs a clear purpose statement with explicit 'Use whenever' triggers and realistic example utterances, including archetype-specific keywords. Its only weakness is moderate specificity, where the named actions overlap and lean somewhat abstract.

Suggestions

Sharpen specificity by naming the concrete remediation operations (e.g., install, re-sync, publish, prune skills) instead of the overlapping 'understand/address/review/triage/clean up' phrasing.

DimensionReasoningScore

Specificity

Names the domain (skill-inventory findings) and several actions (understand, address, review, triage, clean up), but the verbs overlap and stay somewhat abstract rather than enumerating distinct concrete operations. Not a 1 (it is not vague like 'Helps with documents'); not a 3 because it does not list multiple distinct concrete actions the way the PDF example does.

2 / 3

Completeness

Explicitly answers what ('Understand a skill inventory and address its findings') and when ('Use whenever the user asks about...'), with an explicit 'Use whenever' trigger clause plus example utterances. Meets the 'clearly answers both what AND when' anchor.

3 / 3

Trigger Term Quality

Covers natural trigger phrasing ('skill inventory', 'skill-inventory findings', 'review, triage, or clean up findings') and concrete user utterances including archetype-specific terms ('fix the drift findings', 'what untracked skills do I have'). Matches the 'good coverage of natural terms users would say' anchor.

3 / 3

Distinctiveness Conflict Risk

Targets a narrow niche (skill-inventory finding remediation) with distinctive, archetype-specific triggers, making conflict with unrelated skills unlikely. Uses third-person voice throughout with no first/second person.

3 / 3

Total

11

/

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.

Reviewed

Table of Contents