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

82%

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

The canonical home for this skill is reflect in ericjohnolson/tessl-test

SKILL.md
Quality
Evals
Security

Quality

Content

78%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-only skill: the 8-step workflow is highly actionable with exact commands, paths, and commit conventions, and progressive disclosure is exemplary with three real, one-level-deep references. The main weaknesses are systematic redundancy around the plan-mode constraint (stated four times) and a small incoherence in step 5 where writing a file inside plan mode contradicts the stated purpose of plan mode.

Suggestions

State the dispatch-before-plan-mode constraint once (e.g., a single note before Step 2) instead of repeating "— BEFORE Plan Mode" across three consecutive headings, a CRITICAL callout, and an anti-pattern entry.

Drop the Agent Dispatch Manifest markdown template or the dispatch table — they duplicate each other — and trim meta-commentary like "This table provides observable evidence of parallel agent dispatch" that serves evaluation, not the skill user.

Fix the Step 5 incoherence: clarify that the reflection artifact is drafted in plan mode but written to docs/plans/ only after ExitPlanMode (Step 8), replacing the contradictory "synthesis is a read/write-only activity" phrasing.

DimensionReasoningScore

Conciseness

The body is mostly efficient — no explanations of concepts Claude already knows — but contains several tighten-able redundancies: the plan-mode dispatch constraint is stated four times ("— BEFORE Plan Mode" on three consecutive headings, a CRITICAL callout, and an anti-pattern), the Agent Dispatch Manifest template largely duplicates the dispatch table above it, and meta-commentary like "This table provides observable evidence of parallel agent dispatch" serves evaluation rather than the skill's user. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not the level-4 anchor's 'minor instances' since the repetition is systematic.

3 / 5

Actionability

Guidance is fully executable: exact commands ("git log --oneline -20", "git diff HEAD~5..HEAD --stat"), a concrete agent-to-type dispatch table with per-agent read targets, exact commit message formats ("reflect: <description>"), an exact output path pattern, a specified proposal record structure, and detailed prompts in references/agent-prompts.md. Common cases are covered copy-paste ready, matching the level-5 anchor; there are no meaningful gaps that would drop it to level 4.

5 / 5

Workflow Clarity

Eight clearly sequenced, numbered steps with real checkpoints: user approval gate via ExitPlanMode plus All/None/specific AskUserQuestion, a fallback for thin agent results, a git-unavailable fallback, atomic one-commit-per-improvement, and a post-hoc verification ("Verify applied changes with git log --oneline -5"). It misses level 5 on two points: step 5 instructs writing the reflection artifact "to the plan file" while inside plan mode (and "synthesis is a read/write-only activity" is self-contradictory), and the post-apply verification checks commit messages rather than that the edits actually took effect.

4 / 5

Progressive Disclosure

The body is a clear overview with three well-signaled, one-level-deep references — [agent prompts](references/agent-prompts.md), [reflection artifact template](references/template.md), and [improvement guide](references/improvement-guide.md) — all of which exist in references/ and are substantive, matching what the links promise. Content is appropriately split: bulky prompt templates, the artifact format, and the taxonomy live in the bundle while the SKILL.md carries the workflow. This matches the level-5 anchor with no nesting or buried references.

5 / 5

Total

17

/

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: third-person voice, concrete and comprehensive on capabilities, with an explicit use-when clause. Its main limitation is that the "when" clause ("Use after any substantive session") is generic, and natural trigger synonyms (retrospective, what did we learn) live in the triggers field rather than the description text.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Reads recent git history, artifacts, and context files to extract learnings and produce improvement proposals for skills, CLAUDE.md, hooks, and plan templates" — covering inputs, transformations, outputs, and four concrete target types. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and clearly exceeds the level-4 anchor, which permits minor coverage gaps.

5 / 5

Completeness

Both parts are explicit: the "what" is concrete (reads git history/artifacts/context files, extracts learnings, produces proposals) and the "when" is stated ("Use after any substantive session"). It falls short of the level-5 anchor because "any substantive session" is generic rather than concrete trigger phrases; it is more explicit than the level-3 anchor, where "when" is only weakly implied.

4 / 5

Trigger Term Quality

Natural terms present include "Post-session reflection", "session", "learnings", "git history", and "improvement proposals", which a user needing this skill would plausibly say. Common variations like "retrospective", "post-mortem", or "what did we learn" appear only in the separate triggers frontmatter field, not the description itself, so a few natural terms are missing — the level-4 anchor.

4 / 5

Distinctiveness Conflict Risk

"Post-session reflection" plus the specific improvement targets (skills, CLAUDE.md, hooks, plan templates) carves a clear niche that is unlikely to trigger for general review or debugging skills. There is minor overlap risk with closely related skills (e.g., memory-update or code-review skills), which is exactly the level-4 anchor; the level-5 anchor requires trigger phrasing that leaves essentially no conflict risk.

4 / 5

Total

17

/

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

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