CtrlK
BlogDocsLog inGet started
Tessl Logo

ac-context-compactor

Manage and compact context for long sessions. Use when context is filling up, creating handoff summaries, optimizing context usage, or preparing for session continuation.

64

Quality

80%

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/ac-context-compactor/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 lean, well-structured SKILL.md with an executable quick start that accurately reflects the bundled script, a clear threshold-based workflow, and appropriate deferral of implementation detail to the script file. Remaining gaps are modest: duplicated purpose prose, an unexplained force-handoff branch, and an API Reference section that is only a bare file pointer.

Suggestions

Merge the opening line and Purpose section into one sentence to remove duplication, freeing tokens for the missing force-handoff guidance.

Document the "Above 90%" branch concretely — e.g., reference should_force_handoff() and the ac-handoff-creator hand-off — and show one line consuming the returned CompactSummary so the workflow ends somewhere.

Flesh out API Reference with a short table of the script's public methods (should_compact, create_compact_summary, record_decision, update_context_state) instead of a single bare pointer to the file.

DimensionReasoningScore

Conciseness

The body is tight: a working Quick Start snippet, a compact threshold tree, a strategy list, and a concrete JSON output spec, with the implementation bulk correctly deferred to the script file. It falls short of anchor 5 because the opening line and the Purpose section ("Manage context usage and create compact summaries for session continuation" vs. "Monitors context usage and creates compact summaries...") duplicate each other and the frontmatter description, with light marketing padding ("enabling seamless session continuation without losing critical information").

4 / 5

Actionability

The Quick Start is real, executable Python that matches the actual API in scripts/context_compactor.py (ContextCompactor(project_dir), await should_compact(), await create_compact_summary() — all verified against the source), and the Summary Structure JSON gives a concrete output contract. Minor gaps keep it below anchor 5: project_dir is never defined, the snippet mixes await with top-level code, and there is no example of consuming the returned summary.

4 / 5

Workflow Clarity

The workflow is legible and has real decision checkpoints: the threshold tree (below 85% continue, at 85% compact, above 90% force handoff) plus the Quick Start's check-then-compact sequence. It sits below anchor 5 because "Above 90%: Force handoff" names an action the body never explains how to perform (no pointer to ac-handoff-creator's interface or should_force_handoff), and nothing says what to do with the summary once created.

4 / 5

Progressive Disclosure

Good structure: short well-labeled sections, with the full implementation correctly split into scripts/context_compactor.py via a clearly signaled one-level-deep reference (verified to exist and match the documented API). It misses anchor 5 because the "API Reference" section is a bare pointer with no inline summary of the key public methods (record_decision, update_context_state, should_force_handoff), and the Quick Start's import path assumes skill-root context without stating it.

4 / 5

Total

16

/

20

Passed

Description

75%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 well-formed description that follows the what-then-when pattern with an explicit "Use when..." clause and natural trigger phrases. Its main weakness is a somewhat generic "what" sentence ("Manage and compact context") that undersells the skill's concrete capabilities.

Suggestions

Replace the generic verb "manage" in the first sentence with the skill's concrete capabilities, e.g., "Monitors context usage, creates compact summaries at thresholds, and generates handoff summaries for long sessions."

Add common trigger synonyms users might say, such as "context window", "summarize the session", or "running out of context", to widen natural trigger coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "compact context", "creating handoff summaries", "optimizing context usage", "preparing for session continuation" — grounded in a clear domain (long-session context management). It falls short of anchor 5 because "Manage and compact context" leans on the generic verb "manage" and omits capabilities the skill actually has (monitoring usage, threshold-based decisions), but it clearly exceeds anchor 3's 1-2 concrete actions.

4 / 5

Completeness

Both parts are explicit: the "what" ("Manage and compact context for long sessions") and an explicit "Use when..." clause with four concrete triggers. It sits between anchors 4 and 5: the "when" is fully explicit, but the "what" sentence is thinner than anchor-5 examples, relying on the generic "manage" rather than enumerating capabilities, so 4 is the best fit.

4 / 5

Trigger Term Quality

"context is filling up", "handoff summaries", "context usage", and "session continuation" are natural phrases a user would plausibly say when needing this skill. A few natural variants are missing (e.g., "context window", "summarize the conversation", "running out of tokens"), which keeps it below anchor 5's comprehensive synonym coverage but comfortably above anchor 3.

4 / 5

Distinctiveness Conflict Risk

Context compaction for long sessions is a distinct niche with dedicated trigger phrases ("context filling up", "handoff summaries"). There is minor overlap risk with generic summarization or session-management skills, matching anchor 4 rather than anchor 5's minimal-conflict profile.

4 / 5

Total

16

/

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
fernandezbaptiste/Skrillz
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.