CtrlK
BlogDocsLog inGet started
Tessl Logo

reflect

Mid-conversation reflection skill that pauses execution and zooms out from detail-mode to honestly reassess direction, assumptions, and bias. Use when the user says 'reflect', 'take a step back', 'step back', 'zoom out', 'are we missing something', 'bigger picture', 'sanity check this', 'are we on track', 'are we overthinking this', 'forest for the trees', or any variation signaling intent to break out of detail-mode and reassess. Also trigger when the conversation has gone deep on implementation details without strategic check-in, or when the user shows signs of being stuck — that's often a signal the framing needs a reset, not more detail work. Intentionally low-intake: runs the 5-dimension analysis immediately when prior context is rich enough; asks one forcing clarifier only when invocation context is too thin to reassess from.

70

Quality

86%

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 alirezarezvani/claude-skills

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-structured, highly actionable reflection skill with a clear sequenced workflow and concrete output templates. Its main defect is that the body leans on three reference files and three scripts that are not present in the bundle, so the progressive-disclosure links are dangling; secondary redundancy between the tone rules and anti-patterns could be trimmed.

Suggestions

Ship the referenced bundle files (references/cognitive_bias_canon.md, references/honest_output_discipline.md, references/conversation_reflection_practice.md and the three scripts/*.py), or remove the links and inline only what the skill truly depends on — currently every referenced path is a dead link.

De-duplicate the Tone and Format Rules and the Anti-Patterns To Reject section, which restate the same 'no vague reassurance' / 'no manufactured problems' / 'no structured-report output' prohibitions.

Add an explicit validation checkpoint before the closing recommendation (e.g., 'confirm the reassessment names the original goal and at least one drift/assumption/bias with cited turns') to lift workflow clarity.

DimensionReasoningScore

Conciseness

Mostly efficient actionable lists, but there is real redundancy: the Anti-Patterns section restates the Tone and Format Rules, the Stop Directive belabors the pause point, and the full Q1 quoted block is longer than needed. Not below a 4 because the core is tight, not a 5 because of the duplication.

4 / 5

Actionability

Highly concrete for an instruction-only skill: exact output templates ('Continue. {specific reasoning for why}.'), evidence-anchoring prompts ('At turn 3 the goal was X; by turn 12...'), a bias table with recognition cues, and an error-handling table — copy-paste ready guidance covering the common cases.

5 / 5

Workflow Clarity

Clear sequence (trigger → stop → optional Q1 → sequenced 5-dimension checklist → flowing prose → mandatory closing) with an error-handling feedback table; it stays at 4 rather than 5 because there is no explicit self-validation checkpoint confirming the reflection addressed the actual drift.

4 / 5

Progressive Disclosure

The structure is good — overview and framework inline, deeper material signaled as one-level-deep markdown links — but every referenced file is missing: references/cognitive_bias_canon.md, references/honest_output_discipline.md, references/conversation_reflection_practice.md and all three scripts/*.py do not exist in the bundle, so the disclosure promises are broken and navigation fails.

3 / 5

Total

16

/

20

Passed

Description

95%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, well-targeted description: it clearly states what the skill does and gives an exhaustive, natural set of trigger phrases. The only weakness is that it doesn't mention the mandatory closing recommendation in the 'what' clause, a minor specificity gap.

DimensionReasoningScore

Specificity

Names several concrete actions — 'pauses execution', 'reassess direction, assumptions, and bias', 'runs the 5-dimension analysis', 'asks one forcing clarifier' — but omits the closing directional recommendation, leaving a minor coverage gap that keeps it below a 5.

4 / 5

Completeness

Explicitly answers both what ('Mid-conversation reflection skill that pauses execution... reassess direction, assumptions, and bias') and when ('Use when the user says... Also trigger when the conversation has gone deep...') with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Comprehensive natural-phrase coverage users would actually say — 'reflect', 'take a step back', 'zoom out', 'forest for the trees', 'sanity check this', 'are we overthinking this' — plus 'any variation' and implicit signals, matching the top anchor.

5 / 5

Distinctiveness Conflict Risk

Clear niche (mid-conversation reassessment) with distinctive triggers ('zoom out', 'forest for the trees', 'sanity check this') unlikely to fire for an unrelated skill; minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 5 missing

Warning

referenced_paths_exist

Referenced path issues: 13 missing

Warning

Total

14

/

16

Passed

Repository
alirezarezvani/claude-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.