CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aislop

Code-quality gate and coding guardrail for AI coding agents. Always invoke when you finish editing and prepare to hand control back, even if the user did not explicitly ask. Trigger on commit, push, PR, or phrases like any slop, remove slop, review my code, run aislop, or score my code. Scans with aislop, fixes what is mechanical, addresses the rest in-session in the project style, then reports what changed.

Quality

90%

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

92%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.

An excellent instruction-type skill body: every step is backed by executable commands, the workflow has explicit validation loops and exit criteria, and detail is properly pushed to two real, well-signaled reference files. The only weakness is minor trimmable meta-commentary that costs tokens without changing behavior.

DimensionReasoningScore

Conciseness

The body is dense and command-first with no explanations of concepts Claude already knows, but a few meta-justification sentences ("This skill is not 'run aislop and report back' — the user could do that themselves. The value is the judgement layer...") and some repetitive escalation guidance could be trimmed. Efficient with minor instances of over-explanation matches 4; it never drifts into the padded or explanatory territory of 3.

4 / 5

Actionability

Fully executable guidance throughout: copy-paste commands ("aislop scan --changes --json", "aislop fix", pinned-install decision order), concrete grep targets ("pino", "winston", "bunyan", "logger.ts"), a decision table mapping findings to actions, and a complete worked report example. Specific examples cover the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

A clearly sequenced 7-step workflow with an explicit feedback loop (fix, re-scan, "Loop steps 4-6 until" the bar is met), explicit exit criteria ("Do not say 'done' before this point"), and a false-positive verification checklist. Validation checkpoints are present, so the missing-validation cap does not apply, and this matches the 5 anchor's validate-fix-retry structure.

5 / 5

Progressive Disclosure

The body keeps only a category-name index inline and links references/PREVENTIONS.md and references/FIX_GUIDE.md at their point of use; both files exist in the bundle, are one level deep, and are clearly signaled. The split is appropriate — workflow stays in SKILL.md, catalogs live in references — matching the 5 anchor.

5 / 5

Total

19

/

20

Passed

Description

83%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 that clearly states a concrete scan-fix-report pipeline and gives explicit, natural trigger phrases for both always-on and on-demand invocation. Its weaknesses are the second-person trigger clause (voice penalty on specificity) and trigger coverage that omits several natural variations the body itself lists, plus minor overlap risk with general code-review skills.

Suggestions

Rewrite the invocation clause in third person to avoid the voice penalty, e.g. "Always invoked when an editing turn ends and control is handed back, even without an explicit request."

Add the natural trigger variations already present in the body — "any duplicates", "can we dedupe this", "is this too long", "audit my deps" — so trigger coverage is comprehensive.

Narrow the always-invoke scope or qualify the commit/push/PR trigger (e.g. "before commit/push/PR when code-quality gating is requested") to reduce conflict with dedicated code-review and commit-message skills.

DimensionReasoningScore

Specificity

"Scans with aislop, fixes what is mechanical, addresses the rest in-session in the project style, then reports what changed" lists a comprehensive pipeline of concrete actions, but "Always invoke when you finish editing" uses second person, which the guidelines penalize by reducing specificity by 1. It exceeds level 3 (only 1-2 actions) but the voice penalty bars it from 5.

4 / 5

Completeness

Explicitly answers both: what ("Code-quality gate and coding guardrail... Scans with aislop, fixes what is mechanical, addresses the rest in-session... then reports what changed") and when ("Always invoke when you finish editing and prepare to hand control back... Trigger on commit, push, PR, or phrases like...") with concrete trigger phrases. This matches the 5 anchor directly; level 4's weaker 'when' does not apply.

5 / 5

Trigger Term Quality

Quoted natural phrases "any slop", "remove slop", "review my code", "run aislop", "score my code" plus commit/push/PR are phrasings users would actually say, but common variations present in the body ("any duplicates", "can we dedupe this", "audit my deps", "is this too long") are missing. Good coverage with a few natural terms missing matches 4, not comprehensive enough for 5 and well above the sparse coverage of 3.

4 / 5

Distinctiveness Conflict Risk

The aislop/slop niche is distinct with tool-specific triggers, but "review my code", "commit, push, PR", and the always-on "when you finish editing" invocation overlap with code-review and commit-message skills. Mostly distinct with minor overlap risk against closely related skills fits 4; the always-invoke breadth prevents a 5.

4 / 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

scanaislop/skills

Path

skills/aislop/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.