CtrlK
BlogDocsLog inGet started
Tessl Logo

strategic-compact

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction. Use when a session is approaching a context limit and a task phase is a natural place to compact.

61

Quality

73%

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/strategic-compact/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 highly actionable, well-structured skill body with concrete configuration, setup, and decision guidance. Its main weaknesses are the tangential Token Optimization Patterns section and time-sensitive version detail, which cost conciseness without adding skill-specific value.

Suggestions

Move the 'Token Optimization Patterns' section into a separate reference file or cut it to 2-3 lines of pointers — it is generic token-management advice, not instructions for this skill, and costs ~30 lines of context.

Relocate the Claude Code 2.1.233 / model-specific todo-tools detail into a version note or 'deprecated' style section and keep only the durable rule ('write the plan to a file before compacting') in the main body.

Trim the 'Why Strategic Compaction?' conceptual contrast — Claude can infer the downsides of mid-task auto-compaction; the decision table already conveys the guidance operationally.

DimensionReasoningScore

Conciseness

The core sections (hook setup, configuration, decision table) are lean and dense with signal, but the ~30-line 'Token Optimization Patterns' section is a generic tangent (trigger tables, duplicate-rule detection, token-optimizer MCP tools) not specific to this skill, and the task-tools callout carries time-sensitive version numbers (Claude Code '2.1.233', named models) outside any 'old patterns' section. This is 'mostly efficient but includes some unnecessary explanation or could be tightened' — noticeably padded in places but not anchor-2 verbose throughout.

3 / 5

Actionability

Copy-paste-ready hooks JSON, exact environment variables with defaults and token thresholds (e.g., COMPACT_CONTEXT_THRESHOLD 160000/250000, interval 60000), a concrete example command ('/compact Focus on implementing auth middleware next'), and a decision table with explicit Compact?/Why columns. Fully executable guidance covering the common setup and usage cases.

5 / 5

Workflow Clarity

Sequences are clear: plugin-vs-manual setup with an explicit double-execution warning, a phase-transition decision guide, and numbered Best Practices. No destructive or batch operations, so the validation cap does not apply; however there are no explicit validation checkpoints or feedback loops in the compact-decision workflow, keeping it below anchor 5.

4 / 5

Progressive Disclosure

A single, well-sectioned SKILL.md with no bundle files (references/, scripts/, assets/ absent), clear headers, and signposted external artifacts (suggest-compact.js, install.sh, hooks/hooks.json). Good structure and easy navigation; minor gap in that the Token Optimization Patterns section is inline content that could live in a separate reference file, holding it at anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

71%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 an explicit what-and-when structure in third-person voice. The what/when completeness is exemplary; trigger keywords and the breadth of concrete capabilities are the weaker spots.

Suggestions

Add one more concrete capability to the 'what' clause (e.g., 'monitors context size and tool-call count via a hook, then suggests /compact at phase boundaries') to lift specificity from one action to several.

Include natural user phrasings in the trigger clause, such as 'running out of context', 'long session', or 'context window is filling up', to broaden keyword coverage.

Name the concrete artifact or command involved (e.g., '/compact') in the description to sharpen distinctiveness against generic context-management skills.

DimensionReasoningScore

Specificity

"Suggests manual context compaction at logical intervals" names the domain and one concrete action (suggesting compaction at boundaries), but offers only a single capability rather than a list of specific actions. It sits above anchor 2 (the mechanism — compaction at logical task boundaries vs auto-compaction — is concrete) but below anchor 4 (no multi-action coverage).

3 / 5

Completeness

The first sentence explicitly answers what the skill does ("Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction") and the second gives an explicit "Use when..." clause with concrete trigger conditions ("a session is approaching a context limit and a task phase is a natural place to compact"). This matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Relevant keywords are present ("context limit", "session", "task phase", "compact"), but common natural phrasings users would actually say — "running out of context", "context window full", "long session", "compact the conversation" — are missing. This matches "some relevant keywords but missing common variations or synonyms" rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

The niche (timing of manual /compact) is distinct and would not trigger for unrelated skills, but the broad term "context" creates minor overlap risk with general token-optimization or context-management skills. Mostly distinct with minor overlap — anchor 4, not 5.

4 / 5

Total

15

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
affaan-m/ECC
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.