CtrlK
BlogDocsLog inGet started
Tessl Logo

ac-context-optimizer

Optimize context usage for autonomous coding. Use when managing context window, prioritizing information, reducing token usage, or improving efficiency.

54

Quality

68%

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

Quality

Content

61%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 lean and honest about delegating implementation to the script, and the bundle reference is real and one level deep. Its main weaknesses are an undefined-variable Quick Start that cannot run as shown and a missing workflow — nothing tells the reader what the inputs are, how to build them, or what to do with the results.

Suggestions

Make the Quick Start executable: show how to construct `ContextItem` objects (id, content, priority, token_estimate, category, timestamp) so `items` and `current_context` are concrete rather than placeholders.

Merge the opening line and Purpose section into one statement, and use the freed tokens for one or two sentences on when to call `optimize_context` versus `prioritize_information` and how to interpret `OptimizationResult` fields like `tokens_saved` and `new_usage_percentage`.

Turn the API reference into a signaled pointer, e.g. 'See [scripts/context_optimizer.py](scripts/context_optimizer.py) for `ContextItem`, `OptimizationResult`, and all methods', so the reader knows what opening it buys.

DimensionReasoningScore

Conciseness

The body is short, assumes Claude's competence, and explains nothing Claude already knows, but the opening line ('Optimize context window usage for efficient autonomous operation.') and the Purpose section ('Manages and optimizes context usage to maximize effective operation within token limits.') state the same thing twice. Fits 'Efficient; minor instances of over-explanation that could be trimmed' — the duplicated purpose statement is the trimmable redundancy keeping it below 'every token earns its place'.

4 / 5

Actionability

The Quick Start is real Python rather than pseudocode, but `project_dir`, `current_context`, and `items` are undefined placeholders — the body never says what these are, and the bundle's API actually requires `ContextItem` objects that go entirely unmentioned. This matches 'Some concrete guidance but incomplete... missing key details'; not level 4 because the example cannot run or even be adapted without opening the source file.

3 / 5

Workflow Clarity

The two API calls are shown but the surrounding workflow is absent: how to gather context items, when to call `optimize_context` versus `prioritize_information`, and what to do with the returned `OptimizationResult`. It is not a destructive or batch operation, so no cap applies, but the single action is not unambiguous enough for the simple-skill exception; 'sequence present but checkpoints missing or implicit' is the best fit.

3 / 5

Progressive Disclosure

Scored against the actual bundle: one real file (`scripts/context_optimizer.py`), referenced one level deep both in the Quick Start import and an explicit 'API Reference' section, with a short, well-sectioned body. Minor gaps keep it below anchor 5: the reference is a bare path rather than a link, and it gives no hint of what the file contains (key classes, methods, or configuration) to help decide whether to open it.

4 / 5

Total

14

/

20

Passed

Description

58%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 has the right structure — a what-statement followed by an explicit 'Use when' clause — but the what is vague and one trigger ('improving efficiency') is generic filler that dilutes both keyword quality and distinctiveness. Tightening the capability statement and replacing the buzzword trigger with natural synonyms would lift it substantially.

Suggestions

Replace the vague 'what' with concrete capabilities, e.g. 'Prioritizes and prunes context items by category and token cost to stay within the context window.'

Drop the generic trigger 'improving efficiency' and add natural synonyms users would actually say, such as 'context window is filling up', 'token limits', or 'trimming conversation history'.

Consider naming the input/output shape in the description (e.g. 'takes a list of context items and returns an optimized set') to sharpen distinctiveness from general efficiency skills.

DimensionReasoningScore

Specificity

Phrases like "Optimize context usage" and "improving efficiency" are abstract restatements of the domain rather than concrete capabilities; "managing context window, prioritizing information, reducing token usage" name semi-concrete actions but are generic and not comprehensive. Fits the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' better than level 4, whose example lists several distinct specific actions.

3 / 5

Completeness

An explicit "Use when managing context window, prioritizing information, reducing token usage, or improving efficiency" clause gives a clear 'when' with multiple triggers, and "Optimize context usage for autonomous coding" gives a 'what'. It falls short of anchor 5 because the 'what' itself is vague — it does not concretely state what the skill does — while sitting above anchor 3 since the 'when' is explicit rather than weakly implied.

4 / 5

Trigger Term Quality

"context window" and "token usage" are terms a user would plausibly say, but "improving efficiency" is generic filler and natural synonyms or common variations are missing. This matches 'Some relevant keywords but missing common variations or synonyms'; not level 4 because one of the four triggers is pure buzzword, keeping coverage short of 'good'.

3 / 5

Distinctiveness Conflict Risk

The core niche (context window, token usage) is fairly distinct, but the trigger "improving efficiency" would overlap with virtually any performance- or efficiency-related skill. Best fit is 'Somewhat specific but could still overlap with similar skills'; not level 4 because that broad trigger creates real, not minor, overlap risk.

3 / 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
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.