CtrlK
BlogDocsLog inGet started
Tessl Logo

calendar-sort

Sort calendar events by date and priority

59

Quality

69%

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 ./tests/fixtures/clean-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 a tight, well-structured example of a simple single-purpose skill: an explicit sort rule, a clear step sequence, and a worked example that pins down expected output. The only notable gaps are one redundant restatement of the description and an output format defined only by example.

DimensionReasoningScore

Conciseness

The body is lean with no concept explanations Claude already knows, but the opening line "This skill sorts calendar events by date and priority level" merely restates the title/description — a minor instance that could be trimmed, matching 'efficient; minor instances of over-explanation'. Not 5: that one redundant sentence; not 3: everything else earns its place.

4 / 5

Actionability

Concrete instruction-only guidance with an exact ordering rule ("Sort events first by date (ascending), then by priority (high, medium, low)") and a fully worked input/output example. As an instruction-only skill the lack of code is not penalized; "Return the sorted list in a readable format" is the one slightly underspecified step, so it is 'mostly executable guidance with minor gaps' rather than fully executable.

4 / 5

Workflow Clarity

Four unambiguous, clearly sequenced steps (read, parse, sort with explicit ordering rules, return) plus a worked example that demonstrates the correct outcome. Under the simple-skill guideline a single clear task scores 5; sorting is a read-only operation, so the destructive/batch validation cap does not apply. Not 4: no step is ambiguous or missing a checkpoint relevant to this task.

5 / 5

Progressive Disclosure

At 24 lines with no external material needed, the skill is cleanly organized into Instructions and Example sections with no monolithic text, no buried references, and no bundle files (none exist, so no dangling paths). This matches the simple-skill exception where under-50-line well-organized content scores 5.

5 / 5

Total

18

/

20

Passed

Description

53%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 is specific and in proper third-person style, clearly stating a single concrete capability. Its main weakness is the complete absence of a 'when to use' trigger clause and of synonym/extension coverage, which caps both completeness and trigger-term quality at the midpoint.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user asks to sort, order, or organize calendar events, schedules, or event lists by date or priority."

Broaden natural trigger terms with synonyms users actually say, such as "schedule", "meetings", "agenda", or ".ics" files, alongside "calendar events".

Optionally name the output shape (e.g., "...and return a readable sorted list") to round out the 'what' beyond the single sort action.

DimensionReasoningScore

Specificity

"Sort calendar events by date and priority" names the domain (calendar events) and one concrete action with its criteria, matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It is not 4 because only a single action is described with no broader coverage of related operations.

3 / 5

Completeness

The description has a clear 'what' (sorts calendar events by date and priority) but contains no 'when' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because a 'when' element is entirely absent rather than merely vague.

3 / 5

Trigger Term Quality

"calendar events", "date", and "priority" are natural, relevant terms users would say, but common variations and synonyms (e.g., "schedule", "meetings", ".ics") are missing, matching the 'some relevant keywords but missing common variations' anchor. Not 4: keyword coverage is not broad enough to be a near-complete match.

3 / 5

Distinctiveness Conflict Risk

The calendar-event sorting niche is fairly distinct with concrete criteria (date, priority), leaving only minor overlap risk with generic list-sorting or scheduling skills — matching 'mostly distinct; minor overlap risk'. Not 5: the short description lacks trigger phrasing that would fully disambiguate it from adjacent scheduling skills.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
NMitchem/SkillScan
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.