CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

abstraction

Shape a complex idea, workflow, design, or report on work around the judgment a person needs to make. Use when summarizing, reporting on, or explaining complex work to someone who must judge or act on it, or when an explanation obscures its point or makes the user carry unnecessary complexity. Do not use for routine execution of a clear request.

Quality

83%

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

81%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 concise, well-organized conceptual skill body that respects the reader's intelligence and ends with a clear stop condition. The main gap is actionability: it prescribes forms (end with the decision, options with costs) without a worked example or template that shows what a compliant report looks like.

Suggestions

Add one short worked example or before/after sketch showing a judgment-oriented report (e.g., a two-line before 'restates what was done' vs. an after that ends with a decision, options, costs, and a recommendation) to make the prescribed forms concrete.

Add brief section headers (e.g., 'Choosing the form', 'Reporting on work', 'Failure modes') so the reader can locate the guidance relevant to their situation without scanning the full prose.

Convert the reporting prescriptions ('give the options that matter, what each costs, and which you recommend') into a compact checklist format so the actionable sequence is scannable rather than embedded in a paragraph.

DimensionReasoningScore

Conciseness

The ~40-line body is lean and dense: every paragraph carries skill-specific judgment guidance ("Show the governing relationship before its machinery", "Simplification fails when it hides uncertainty"), with no padding and no explanation of concepts Claude already knows. Every token earns its place.

5 / 5

Actionability

Some concrete directives are present — "end with it, after the evidence it depends on", "give the options that matter, what each costs, and which you recommend", "Draw it from the work itself, such as the diff or the tests" — but the guidance stays conceptual throughout, with no worked example or before/after template demonstrating the form. Not level 4 because 'mostly executable' guidance would show concrete exemplars of the prescribed forms.

3 / 5

Workflow Clarity

This is a simple, single-purpose skill under 50 lines with no multi-step process, so the simple-skill exception applies: the single action (shape the presentation around the reader's judgment) is unambiguous, and the body reads as a coherent progression ending in an explicit terminal checkpoint — "Stop when the person can make the next judgment without reconstructing the machinery behind it." No destructive or batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

The body is short enough that no content needs splitting, and the one cross-link ([dialectic](../dialectic/SKILL.md)) is clearly signaled and one level deep; no nested references or inlined reference material. Not level 5 because the body has no section headers to aid navigation, and the referenced sibling-skill path cannot be verified within the bundle.

4 / 5

Total

17

/

20

Passed

Description

78%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 explicitly states what the skill does, gives concrete natural-language triggers for when to use it, and adds a negative trigger to reduce misfires. Its main weakness is specificity — the capability is framed as a single shaping action rather than several concrete, enumerable actions.

DimensionReasoningScore

Specificity

The description names its domain ("a complex idea, workflow, design, or report on work") and one framing action ("Shape... around the judgment a person needs to make"), but does not enumerate several concrete capabilities the way strong examples do. It fits 'names domain and 1-2 concrete actions' rather than 'lists several specific actions'.

3 / 5

Completeness

It explicitly answers both what ("Shape a complex idea... around the judgment a person needs to make") and when with concrete trigger phrases ("Use when summarizing, reporting on, or explaining complex work to someone who must judge or act on it, or when an explanation obscures its point..."), plus explicit negative scoping. This matches the anchor for clearly and explicitly answering both.

5 / 5

Trigger Term Quality

Natural user phrases are present — "summarizing, reporting on, or explaining complex work", "obscures its point", "unnecessary complexity", and a negative trigger "routine execution of a clear request". Common synonyms like "simplify", "recap", or "TL;DR" are missing, so it falls just short of comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The qualifier "to someone who must judge or act on it" and the "Do not use for routine execution" clause carve out a mostly distinct niche, with only minor overlap risk against generic summarization or communication skills. It is more distinct than the anchor-3 example but lacks the sharply unique triggers of a clear niche.

4 / 5

Total

16

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

EpicenterHQ/epicenter

Path

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