CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reflect

Post-session reflection skill. 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.

Quality

87%

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

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.

A well-engineered instruction skill: an unambiguous 8-step workflow with approval checkpoints, copy-paste-ready commands and formats, and clean progressive disclosure to three real reference files. The only gaps are minor redundancy around the plan-mode emphasis and a missing per-edit validation step inside the apply loop.

DimensionReasoningScore

Conciseness

The body is prescriptive and dense — tables, exact commands, commit formats — with no explanations of concepts Claude already knows. The "BEFORE Plan Mode" emphasis is repeated in three step headings, in bold callouts ("CRITICAL: Dispatch ALL agents..."), and again in the anti-patterns list; the dispatch manifest table is also specified in full when a one-line requirement would do. These minor redundant patches fit the 4 anchor (efficient, minor instances that could be trimmed) rather than 5's every-token-earns-its-place, and well above 3's unnecessary explanation.

4 / 5

Actionability

Guidance is fully executable: exact git commands ("git log --oneline -20", "git diff HEAD~5..HEAD --stat"), an agent dispatch table with types and inputs, verbatim AskUserQuestion prompts and answer options ("All / None / specific items by number"), exact artifact path format ("docs/plans/YYYY-MM-DD-{topic}-reflection.md"), exact commit message prefixes, and full agent prompt templates offloaded to a reference file. This matches the 5 anchor for an instruction-only skill with concrete, specific guidance covering the common cases.

5 / 5

Workflow Clarity

An explicit, ordered 8-step sequence with real checkpoints: user review via ExitPlanMode, an approval gate via AskUserQuestion before any writes, thin-agent-result handling, and post-hoc verification ("Verify applied changes with git log --oneline -5"). It does not hit the 5 anchor because the apply loop ("Read the target file / Apply the change / Commit") lacks a per-edit validation step before committing, and the final verification lives in an optional-sounding "After Reflect" checklist. The destructive/batch cap at 3 does not apply since user approval gates every change.

4 / 5

Progressive Disclosure

The body is a clear overview that offloads detail to three real, one-level-deep, clearly linked reference files: [agent prompts](references/agent-prompts.md), [reflection artifact template](references/template.md), and [improvement guide](references/improvement-guide.md) — all verified to exist in the bundle. Content is appropriately split (prompts, template, taxonomy out; orchestration and constraints in), matching the 5 anchor.

5 / 5

Total

18

/

20

Passed

Description

83%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 that explicitly covers what the skill does with specific actions and targets, plus an explicit when-to-use clause. Its weaknesses are mild: the trigger vocabulary could include more natural synonyms (retrospective, lessons learned), and the "Use after any substantive session" clause could name concrete qualifying session types.

Suggestions

Add natural trigger synonyms such as "retrospective" or "lessons learned" to the description so users phrasing the need those ways match the skill (these appear in the frontmatter triggers list but not the description itself).

Sharpen the when clause from "Use after any substantive session" to concrete triggers, e.g., "Use after finishing a feature, refactor, or debugging session, or when the user asks what went well or what to improve."

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with named inputs and outputs: "Reads recent git history, artifacts, and context files to extract learnings and produce improvement proposals for skills, CLAUDE.md, hooks, and plan templates." It names what is read, what is produced, and four concrete target types — comprehensive coverage matching the 5 anchor rather than the 4 anchor, which allows for minor gaps.

5 / 5

Completeness

Both "what" (reads git history/artifacts/context files, extracts learnings, produces improvement proposals) and "when" ("Use after any substantive session") are explicitly present, so it clears the 3 cap. However, the "when" clause rests on the subjective qualifier "substantive" without concrete trigger phrases (e.g., after finishing a feature, refactor, or debugging session), fitting the 4 anchor where the "when" could be more explicit or specific rather than the 5 anchor's concrete trigger phrases.

4 / 5

Trigger Term Quality

The description contains good natural keywords — "Post-session reflection", "learnings", "git history", "improvement proposals" — but misses common variations a user would naturally say such as "retrospective", "lessons learned", or "retro". This fits the 4 anchor (good keyword coverage, a few natural terms missing) better than 5, which requires comprehensive synonyms; it is clearly above 3, which would lack even relevant keywords.

4 / 5

Distinctiveness Conflict Risk

"Post-session reflection skill" claims a clear niche with distinct triggers (reflection/learnings/improvement proposals) that no document-, code-, or data-processing skill would naturally claim. Minimal conflict risk, matching the 5 anchor's clear niche with distinct triggers.

5 / 5

Total

18

/

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

ericjohnolson/tessl-test

Path

tiles/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.