CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reflect

Post-session reflection skill for review session, retrospective, or session summary. Reads recent git history, artifacts, and context files to extract learnings and produce improvement proposals for skills, CLAUDE.md, hooks, and plan templates. Use after any substantive session to capture what did we learn and embed improvements back into codebase context.

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary instruction-only orchestration skill: fully actionable steps, strong validation gates (user review, atomic commits, post-apply verification), and clean one-level-deep progressive disclosure. The only weakness is minor redundancy between the Constraints and Anti-Patterns sections.

DimensionReasoningScore

Conciseness

The body is lean — terse tables, exact commands, no explanations of concepts Claude already knows — but the Anti-Patterns section duplicates constraints already stated in steps 5 and 7 ("Cap at 5 proposals max" vs "Don't propose more than 5 improvements"; "Do NOT bundle" vs "Don't bundle multiple fixes in one commit"), which is minor trimming opportunity matching the efficient-with-minor-overexplanation anchor.

4 / 5

Actionability

Fully concrete, executable guidance: exact commands ("git log --oneline -20", "git diff HEAD~5..HEAD --stat"), exact output path pattern, commit message formats ("reflect: <description>"), a four-agent dispatch table, and full prompt templates in a real references file. Copy-paste ready for this orchestration task.

5 / 5

Workflow Clarity

Eight explicitly ordered steps with repeated "BEFORE Plan Mode" ordering guards, a user-approval gate (All/None/by number) before applying changes, an error-handling rule for thin agent results, atomic one-commit-per-improvement, and post-apply verification ("git log --oneline -5") — explicit validation checkpoints and feedback loops throughout.

5 / 5

Progressive Disclosure

The SKILL.md is a well-sectioned overview with three clearly signaled, descriptive links ([agent prompts], [reflection artifact template], [improvement guide]) that all exist in references/, are one level deep, and hold the deferred detail (prompt templates, taxonomy, artifact format) — matching the clear-overview anchor.

5 / 5

Total

19

/

20

Passed

Description

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

A strong description with concrete capability statements and an explicit use trigger. The main gaps are missing natural trigger variations (lessons learned, retro, post-mortem) and a slightly abstract "substantive session" trigger, plus a grammatically awkward "capture what did we learn" clause.

Suggestions

Add natural trigger synonyms such as "lessons learned", "retro", or "post-mortem" to the keyword coverage.

Make the 'when' clause more concrete, e.g. "Use when the user asks to reflect on or summarize a just-finished session" instead of the undefined "any substantive session".

Fix the awkward phrasing "capture what did we learn" to "capture lessons learned".

DimensionReasoningScore

Specificity

"Reads recent git history, artifacts, and context files to extract learnings and produce improvement proposals for skills, CLAUDE.md, hooks, and plan templates" names concrete inputs, actions, and targets with comprehensive coverage of both inputs and outputs, matching the multiple-specific-actions anchor.

5 / 5

Completeness

Both what ("Reads recent git history... to extract learnings and produce improvement proposals") and when ("Use after any substantive session") are present and explicit, but "substantive" is undefined and the trigger is slightly abstract compared to the concrete trigger phrases of the 5 anchor.

4 / 5

Trigger Term Quality

"review session, retrospective, or session summary" are natural phrases a user would say, but common variations like "lessons learned", "retro", or "post-mortem" are missing. Better than 3 (several natural terms present); short of 5 (no synonym/variation completeness).

4 / 5

Distinctiveness Conflict Risk

The post-session improvement loop is a clear niche with distinct targets (SKILL.md files, CLAUDE.md, hooks), but "for review session" phrasing carries minor collision risk with code-review skills, so it is mostly distinct rather than minimal-conflict.

4 / 5

Total

17

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

ericjohnolson/tessl-test

Path

plugins/crafter/skills/reflect/SKILL.md

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.