CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

strategic-compact

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

50

Quality

63%

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

Quality

Content

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

The body is well-organized with genuinely useful operational tables and concrete configuration, but it is undermined by referencing a script that is not shipped in the bundle, leaving the core setup non-executable. Trimming the redundant rationale sections and resolving the dangling references would raise quality across several dimensions.

Suggestions

Ship 'suggest-compact.js' in scripts/ — the Hook Setup section is unusable without it, since the hook command points directly at that file.

Add a post-setup verification step (e.g., trigger an Edit and confirm the suggestion output appears, or run the script against a sample transcript payload).

Trim 'Why Strategic Compaction?' (it duplicates 'When to Activate') and either give the 'Related' entries real paths or drop them.

DimensionReasoningScore

Conciseness

The body is mostly efficient — the threshold mechanics, config vars, and both tables are dense, operational content — but it can be tightened: the opening sentence duplicates the frontmatter description, 'Why Strategic Compaction?' substantially overlaps 'When to Activate', and the 'Related' section carries a vague x.com link and two unpathed references. Anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') fits better than 4.

3 / 5

Actionability

There is strong concrete material (copy-paste hook JSON, exact env vars with defaults, exact token thresholds), but the hook command points to '~/.claude/skills/strategic-compact/suggest-compact.js' and no such script ships in the bundle — no scripts/ directory exists. The central executable component is missing, so the setup cannot be completed as shipped. That is a missing key detail (anchor 3), more than the 'minor gaps' of anchor 4.

3 / 5

Workflow Clarity

Setup is a single clear copy-paste step, and the 'Compaction Decision Guide' table supplies explicit per-phase decision checkpoints ('Mid-implementation: No', 'After a failed approach: Yes') that make the follow-through action unambiguous. Not 5 because there is no validation step (e.g., how to confirm the hook fires or inspect its output); not 3 because the sequence that exists is complete and checkpointed for its purpose. The destructive/batch cap does not apply — compaction suggestions are advisory.

4 / 5

Progressive Disclosure

The ~100-line body is well-sectioned and appropriately self-contained, but its file references don't resolve: the referenced 'suggest-compact.js' does not exist in the bundle, and the 'Related' items (an x.com post, unpathed 'Memory persistence hooks' and 'continuous-learning' skill) lead nowhere concrete. That matches anchor 3 ('some structure... references present but not clearly signaled'); it is not 2 since no bulk content that belongs in separate files is inlined.

3 / 5

Total

13

/

20

Passed

Description

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

The description communicates a clear, single-sentence 'what' in a distinct niche, but it is missing the 'when' entirely and has thin trigger-term coverage. Adding an explicit 'Use when...' clause with natural trigger phrases would lift it substantially.

Suggestions

Add a 'Use when...' clause with explicit triggers, e.g. 'Use when running long sessions approaching the context limit, between task phases, or when the user mentions compaction or /compact.'

Include natural trigger phrases users would actually say: 'compact', '/compact', 'context window', 'context limit', 'long session'.

Broaden the 'what' to cover the skill's concrete mechanisms (hook-based suggestion at token/tool-call thresholds with configurable env vars) for fuller capability coverage.

DimensionReasoningScore

Specificity

The description names the domain ('manual context compaction') and one concrete action ('Suggests manual context compaction at logical intervals'), but stops there — it omits the skill's actual mechanisms (PreToolUse hook, token/call thresholds, configuration). This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'), not 4, which requires several specific actions.

3 / 5

Completeness

The 'what' is clear ('Suggests manual context compaction at logical intervals to preserve context through task phases'), but the 'when' is entirely absent — no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the 'when' is not even weakly implied by any phrase in the text.

3 / 5

Trigger Term Quality

'context compaction' and 'auto-compaction' are relevant keywords a user might say, but common natural variations are absent: '/compact', 'context window', 'context limit', 'long session'. Anchor 3 ('some relevant keywords but missing common variations or synonyms') fits; it is above 2 (keywords are domain-relevant, not generic) but below 4 (coverage is thin).

3 / 5

Distinctiveness Conflict Risk

'context compaction' / 'auto-compaction' is a clear niche unlikely to collide with other skills' triggers — mostly distinct with minor overlap risk (anchor 4). Not 5 because the anchor-5 example pairs a clear niche with explicit, distinct trigger phrases, which this description lacks entirely.

4 / 5

Total

13

/

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

ysyecust/everything-claude-code

Path

.agents/skills/strategic-compact/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.