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.

2.06x
Quality

67%

Does it follow best practices?

Impact

97%

2.06x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/strategic-compact/SKILL.md

The canonical home for this skill is strategic-compact in ysyecust/everything-claude-code

SKILL.md
Quality
Evals
Security

Quality

Content

67%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, mostly lean advisory skill with a genuinely useful decision table and copy-paste hook setup. Its main defect is that the referenced suggest-compact.js script is absent from the bundle, making the hook configuration non-functional as shipped. Workflow clarity and organization are solid for a single-purpose guidance skill.

Suggestions

Bundle the suggest-compact.js script (e.g. in scripts/) — the Hook Setup JSON points to it but the file does not exist in the skill, so the setup fails as written.

Trim the 'Why Strategic Compaction?' section, which explains auto-compaction behavior Claude already knows, down to the one-line contrast.

State how the tool-call count persists (or resets) across compaction so the user can reason about the 50-call threshold meaningfully.

DimensionReasoningScore

Conciseness

The body is efficient — compact tables ('What Survives Compaction', 'Compaction Decision Guide') and a copy-paste hook config — with only minor over-explanation, e.g. 'Auto-compaction triggers at arbitrary points... No awareness of logical task boundaries' restates behavior Claude already knows. Not 3 because padding is isolated to one section; not 5 because 'Why Strategic Compaction?' and parts of 'Best Practices' could be trimmed.

4 / 5

Actionability

Concrete elements exist (the settings.json hook block, COMPACT_THRESHOLD env var, '/compact Focus on implementing auth middleware next'), but the core mechanism 'node ~/.claude/skills/strategic-compact/suggest-compact.js' references a script that is not bundled in the skill, leaving the primary executable path incomplete. Not 4 because a missing key script is more than a minor gap.

3 / 5

Workflow Clarity

As an advisory skill it provides a clear decision workflow — the phase-transition table ('Research → Planning | Yes', 'Mid-implementation | No') plus the checkpoint 'The hook tells you when, you decide if' — with most decision points explicit. Not 5 because there is no guidance on recovering when compaction discards something still needed; not 3 because sequence and decision checkpoints are present and unambiguous for a non-destructive task.

4 / 5

Progressive Disclosure

Single-file skill with well-organized sections and no nested or buried references; the 'Related' section points to clearly labeled external resources. Not 5 because at ~100 lines the persistence/survives tables are borderline content that could live in a reference file, keeping the overview leaner.

4 / 5

Total

15

/

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, distinct purpose in third person, but it stops at a single stated action and omits any explicit 'when to use' trigger guidance. It reads as a what-only description, which caps completeness and leaves natural trigger terms like '/compact' and 'context window' absent. Adding a trigger clause and one or two more concrete actions would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g. 'Use when running long sessions, approaching the 200K context limit, or transitioning between task phases like research to implementation.'

Include natural trigger terms users would actually say: 'compact', '/compact', 'context window', 'auto-compact', 'long session'.

List one or two more concrete actions, such as 'installs a PreToolUse hook that suggests /compact at a configurable tool-call threshold'.

DimensionReasoningScore

Specificity

Phrases like 'Suggests manual context compaction at logical intervals' name the domain and one concrete action, matching the anchor for 1-2 concrete actions without comprehensive coverage. Not 4 because no further specific actions (hook, threshold tracking, /compact usage) are listed; not 2 because the action stated is concrete rather than generic.

3 / 5

Completeness

The 'what' is clear ('Suggests manual context compaction at logical intervals') but the 'when' is only weakly implied through 'task phases rather than arbitrary auto-compaction' — there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines. Not 4 because no explicit usage condition is stated at all.

3 / 5

Trigger Term Quality

Relevant keywords are present ('manual context compaction', 'auto-compaction', 'task phases') but natural user phrases are missing — users would say 'compact', '/compact', 'context window is filling up', or 'long session', none of which appear. This matches 'some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

Context compaction is a clear niche ('preserve context through task phases rather than arbitrary auto-compaction') that is easily distinguishable from most skills, with only minor overlap risk against memory/persistence-type skills. Not 5 because without explicit trigger phrases the boundary with those adjacent skills is somewhat blurred.

4 / 5

Total

13

/

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

saski/arnesto

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.