CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

headroom

Evaluate or integrate Headroom for large repetitive tool outputs, JSON, logs, or retrieved context. Use when the user names Headroom or asks to measure context compression in an application they control. Start with a local library trial; not a default proxy, provider switch, prose-shortening mode, or solution for an ordinary small command result.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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, safety-conscious runbook: lean body, concrete configuration, explicit evidence-preservation checks with fallback behavior, and a genuine one-level reference split that keeps the overview short. The main deductions are the inline version pin and a code snippet that is not self-contained runnable.

Suggestions

Move the 'headroom-ai==0.39.1' version pin and other time-sensitive details out of the body into the reference file (or a dedicated pinned-versions section) so the body stays version-agnostic.

Make the inline code example copy-paste ready by defining the 'messages' input or pointing directly to the runnable references/local-smoke.py fixture at the point of the snippet.

DimensionReasoningScore

Conciseness

The body is lean, assumes Claude's competence, and never explains general concepts, but the inline version pin 'headroom-ai==0.39.1' is time-sensitive information not placed in an old-patterns/deprecated section, which the guidelines say should penalize conciseness. It fits 'efficient; minor instances that could be trimmed' better than the 'every token earns its place' top anchor.

4 / 5

Actionability

Mostly executable guidance: a concrete CompressConfig code block with a pinned package, explicit flags, and deferral of exact commands to the runnable reference fixture. It is not copy-paste ready because 'messages' is undefined in the snippet and the install/run commands live in the reference file, matching 'concrete code or commands with minor gaps' rather than 5.

4 / 5

Workflow Clarity

The sequence (choose integration → local trial → evidence-preservation checks → report/contain) is clear and the evidence section includes explicit validation ('Compare downstream answers and required assertions with and without compression. Token reduction alone is not success.') plus a fallback loop ('If data is missing... use the original payload and report the limitation'). The main flow is implied by section order rather than an explicitly enumerated step list, and install/verify commands are offloaded to the reference, so it does not fully match the 5 anchor's explicit end-to-end sequence with feedback loops.

4 / 5

Progressive Disclosure

The body is a ~65-line overview with well-organized sections that moves exact commands, observed results, and evaluation methodology into a clearly signaled, one-level-deep reference ('the example in [local trial](references/local-trial.md)'), which is a real bundle file that in turn points to the real local-smoke.py fixture beside it. Content is appropriately split and navigation is easy, matching the top anchor.

5 / 5

Total

17

/

20

Passed

Description

82%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: explicit what/when with concrete trigger phrases, third-person imperative voice, and unusually good negative boundary guidance that lowers conflict risk. The only meaningful gap is capability specificity — the actions are broad verbs rather than an enumerated list of what the skill does.

DimensionReasoningScore

Specificity

The description names the domain and payload types ('large repetitive tool outputs, JSON, logs, or retrieved context') with a couple of concrete actions ('Evaluate or integrate Headroom', 'measure context compression', 'Start with a local library trial'), but the verbs are broad and the coverage of what the skill actually does is not comprehensive. It sits at the 'names domain and 1-2 concrete actions' anchor rather than 4, which would require several specific actions with only minor gaps.

3 / 5

Completeness

It explicitly answers both questions: 'what' ('Evaluate or integrate Headroom for large repetitive tool outputs, JSON, logs, or retrieved context') and 'when' ('Use when the user names Headroom or asks to measure context compression in an application they control'), plus explicit negative boundaries ('not a default proxy, provider switch, prose-shortening mode, or solution for an ordinary small command result'). The trigger clause is concrete, matching the top anchor; a 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good keyword coverage: the product name ('the user names Headroom'), 'context compression', 'JSON', 'logs', 'tool outputs', and 'retrieved context' are all natural phrases a user would say. A few common variations ('context window', 'token usage/limits', 'trim context') are missing, so it does not reach comprehensive synonym-level coverage.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Headroom context compression for large repetitive payloads) with distinct triggers and explicit exclusions that preempt overlap with proxy, provider-switch, and prose-shortening skills. Conflict risk is minimal; the 4 anchor (minor overlap with closely related skills) is weaker than the actual fit.

5 / 5

Total

17

/

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

saski/arnesto

Path

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