CtrlK
BlogDocsLog inGet started
Tessl Logo

wrap-up

End-of-session skill that captures learnings into the right doc layer and updates project instructions.

60

Quality

75%

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 ./skills/wrap-up/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 an exemplary lean instruction skill: a decision gate, an exact routing table, restraint rules with specific constraints, pruning, and reporting, all in under 50 lines. Its only real weakness is an implicit assumption that the documented docs/ structure already exists, with no guidance for the case where it doesn't.

DimensionReasoningScore

Conciseness

The ~46-line body is lean and assumes Claude's competence throughout — even the one rationale line ("Documentation that restates the code is worse than no documentation") earns its place by justifying the write-nothing default. Every sentence is an instruction or a decision rule; there is no padding or explanation of concepts Claude already knows.

5 / 5

Actionability

The routing table gives exact destinations (docs/conventions/, docs/subsystems/, docs/ARCHITECTURE.md, AGENTS.md) plus concrete rules like "one clause with an accurate `<!-- paths: -->` glob" and "keep it under 50 lines" — actionable for an instruction-only skill. It stops short of 5 because it assumes the docs/ tree already exists and never says what to do when it doesn't (only "if nothing in the table fits, ask the user").

4 / 5

Workflow Clarity

The four-step sequence (decide → route → prune → report) is clear, with a strong validation gate in Step 1 ("The default is to write nothing" plus a six-item skip list) and a reporting step that serves as a closing checkpoint. Doc pruning is a mild, git-recoverable deletion rather than the batch/destructive operation the cap targets, but the absence of any post-edit verification (e.g., confirming index entries match new files) keeps it at 4 rather than 5.

4 / 5

Progressive Disclosure

This is a single-file skill under 50 lines with no bundle files (references/, scripts/, assets/ are absent) and no content that warrants splitting; the four section headers are well-organized. Per the rubric's simple-skill guideline, well-organized sections alone justify a 5; the paths mentioned in the body (docs/CONVENTIONS.md, .github/instructions/...) are project edit targets, not skill bundle references.

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 states a clear, moderately specific "what" for a distinctive niche, but omits any "when to use" trigger guidance and relies on the separate triggers metadata for natural user phrasing. Adding a "Use when the user wraps up or ends a session..." clause with a few natural phrases would lift specificity, trigger quality, and completeness simultaneously.

Suggestions

Append a 'Use when...' clause with natural trigger phrases (e.g., "Use when the user says wrap up, finish this session, or done for the day") so the description alone carries the trigger guidance currently confined to the triggers metadata.

Name one or two more concrete routing behaviors in the description (e.g., "routes conventions, subsystem, and guide entries into docs/ and prunes stale docs") to raise specificity from two stated actions to several.

Avoid vague phrasing like "the right doc layer" — name the layers (docs/conventions, docs/subsystems, AGENTS.md) so the capability is concrete on its face.

DimensionReasoningScore

Specificity

"captures learnings into the right doc layer and updates project instructions" names the domain plus exactly two concrete actions, matching the 1-2-actions anchor. It stays at 3 because it omits the skill's other specific behaviors (routing conventions vs. guides vs. subsystems, pruning stale docs) that would justify 4.

3 / 5

Completeness

There is a clear "what" (capture learnings into the right doc layer, update project instructions) but no "when"/"Use when..." clause in the description itself, which per the judging guidelines caps completeness at 3. Not 2 because the "what" half is specific and well-stated.

3 / 5

Trigger Term Quality

The description offers "End-of-session", "captures learnings", and "project instructions" — some relevant keywords — but the natural phrases users would actually say ("wrap up", "finish this session", "done for the day") live only in the separate triggers metadata, not in the description, missing common variations.

3 / 5

Distinctiveness Conflict Risk

The end-of-session doc-routing niche is distinctive and unlikely to fire for an unrelated skill, with only minor overlap risk with general documentation or memory/journaling skills. It falls short of 5 because the description alone carries no trigger phrasing to fully disambiguate it.

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository
RoleModel/rolemodel-skills
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.