CtrlK
BlogDocsLog inGet started
Tessl Logo

semantic-compression

Re-encode verbose prose into a dense telegraphic register — punctuation as connectives, label frames, verbless assertions — without losing normativity or precision. Use when compressing system prompts, tool/function descriptions, skill bodies, or agent instructions; reducing token count or context bloat; making documentation token-efficient for LLM input; or rewriting text in compressed notation.

74

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

88%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-crafted, self-exemplifying skill body: the workflow is explicitly gated and validated end-to-end, the guidance is maximally concrete via frames, operators, deletion lists, and a worked example, and the prose is dense with no filler. The two residual costs of keeping everything in one ~140-line file are a few trimmable rationale passages and the absence of a reference split for the catalog material.

Suggestions

Trim the audit anecdotes in 'Running it as a command' (live-session audit, injected-paragraph test) to their one-line conclusions, keeping the operative contract — this would lift conciseness to the lean register the skill itself prescribes.

Consider moving the Frames/Operators catalogs or the CLI contract for `omp compress` into a one-level-deep references/ file, keeping SKILL.md as the overview plus procedure.

If the skill ships outside the repo containing packages/coding-agent/src/compress/prompts/system.md, inline or copy the operative subset so the pointer is resolvable wherever the skill is installed.

DimensionReasoningScore

Conciseness

The body is dense and self-applying — it assumes Claude's intelligence, explains nothing elementary (no 'what a token is', no library tutorials), and nearly every line carries instruction or measured evidence (e.g. the token-cost table in "Symbols do not save tokens; structure does"). It is not a 5 because a few passages carry rationale that could be trimmed — the paragraph on session isolation in "Running it as a command" ("Its session is isolated on purpose, because... Audited on a live session") and the audit anecdote about the injected-paragraph test run longer than the operative instruction they support.

4 / 5

Actionability

For an instruction-only skill the guidance is fully concrete and executable: a numbered 8-step procedure, a frames table giving English-to-compressed transformations for every claim type, an explicit operator glossary, itemized always/never delete lists, and a worked example with source, compressed output, and a rejected over-compression with reasons. This matches the 5 anchor's 'specific examples cover the common cases' — the guidance leaves no step to invention.

5 / 5

Workflow Clarity

The sequence is explicit with validation checkpoints at both ends: step 0 is a pre-flight density gate with a measured stop condition ("delta under ~10%? STOP"), and the Verification section is a four-step loop with an ambiguity scan ('can a reader assign a second reading? Fix it'), tokenizer-based measurement, declared-loss auditing, and a stop rule. This is the 5 anchor's 'explicit validation steps; feedback loops for error recovery' — well above the 4 anchor, which tolerates minor validation gaps.

5 / 5

Progressive Disclosure

The single file is well-sectioned (Procedure, Frames, Operators, Deletion, Private register, Tool and skill descriptions, Worked example, Verification, CLI section) with clear headings and tables, and its one external pointer (the runtime contract at `packages/coding-agent/src/compress/prompts/system.md`) is clearly signaled. It is not a 5: at ~140 lines of dense material — over the under-50-line simple-skill exception — the frames/operators catalog and the CLI contract section are candidates for a one-level-deep reference file, which is exactly the 'minor organization gap' of anchor 4 rather than the fully appropriate split of anchor 5. It is clearly above anchor 3, whose structure is genuinely weak and references buried.

4 / 5

Total

18

/

20

Passed

Description

95%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: it states a concrete, mechanism-level 'what' and an explicit, synonym-rich 'Use when' clause covering all natural trigger phrasings for the task. The only minor gap is that the capability list is one transformation described via its techniques rather than several enumerated actions, which keeps specificity just below comprehensive.

DimensionReasoningScore

Specificity

The 'what' is concrete and mechanism-specific — "Re-encode verbose prose into a dense telegraphic register — punctuation as connectives, label frames, verbless assertions — without losing normativity or precision" names the transformation and its constituent techniques. It sits between anchor 4 (several specific actions, minor gaps) and anchor 5: the description covers one core operation plus its technique vocabulary rather than multiple distinct actions, so it is not fully comprehensive — but it is noticeably above the 3 anchor ('1-2 concrete actions').

4 / 5

Completeness

Both halves are explicit: 'what' is the opening sentence (re-encode prose into a telegraphic register without losing normativity or precision) and 'when' is an explicit "Use when..." clause with concrete trigger phrases across four trigger families. This matches the 5 anchor exactly; it is clearly above the 4 anchor, whose 'when' is present but less specific.

5 / 5

Trigger Term Quality

The 'Use when' clause provides comprehensive natural-phrase coverage with synonyms: "compressing system prompts, tool/function descriptions, skill bodies, or agent instructions; reducing token count or context bloat; making documentation token-efficient for LLM input; or rewriting text in compressed notation" — a user would naturally say 'compress', 'reduce token count', 'token-efficient', or 'context bloat'. These are the natural phrasings for this need, matching the 5 anchor's comprehensive synonym coverage (no file extensions are applicable to this domain).

5 / 5

Distinctiveness Conflict Risk

The niche is distinct — token-level re-encoding of load-bearing LLM text (system prompts, tool descriptions, agent instructions) — and the triggers ('reducing token count', 'context bloat', 'token-efficient') are specific to this domain, not overlapping with generic summarization or editing skills. It does not match the 4 anchor's 'minor overlap risk with closely related skills' because the trigger phrases name the token-compression intent explicitly.

5 / 5

Total

19

/

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
can1357/oh-my-pi
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.