CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

simplify-and-harden

Post-completion self-review for coding agents that runs simplify, harden, re-verification, and micro-documentation passes on non-trivial code or high-impact configuration changes. Use when a task is complete in a general agent session and you want a bounded quality and security sweep before signaling done. For CI pipeline execution, use simplify-and-harden-ci.

65

Quality

82%

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

70%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 skill's core workflow is exemplary — ordered passes, per-pass checklists, mandatory re-verification with feedback loops, and hard budget constraints. Its weaknesses are length and disclosure: overlapping rationale/philosophy sections inflate the body, and sizable blocks (output schema example, install, compatibility lists) should live in reference files rather than inline.

Suggestions

Move the worked output-schema example, install instructions, and agent-compatibility/integration sections into files under references/ so SKILL.md stays a lean overview with one-level-deep pointers.

Consolidate the overlapping rationale sections ("Rationale and Philosophy", "Design Decisions", "Execution Model") into a short design-notes section, and remove the duplicated trigger-exclusion list.

Tighten the Pass 1/Pass 2 checklists to the concrete prompts an agent executes, dropping repeated restatements of the stop-hook rules.

DimensionReasoningScore

Conciseness

The body (~570 lines) does not explain generic concepts Claude already knows, but it is padded with overlapping rationale sections: "Rationale and Philosophy", "Design Decisions", "Execution Model", "Agent Compatibility", and "Integration Notes" restate the stop-hook and scope rules multiple times, and the "does NOT activate when" list duplicates the non-trivial=false conditions.

3 / 5

Actionability

Concrete checklists, explicit budget limits ("20% of the original diff size", "60 seconds"), apply/approve categorization rules, a copy-paste config YAML, a directly usable prompt-injection block, and a full output schema make the guidance mostly executable. The agent-integration snippet (`agent.on('task:complete', ...)`) is illustrative pseudocode rather than runnable code for any specific agent, keeping it below a 5.

4 / 5

Workflow Clarity

The four passes are explicitly ordered ("Four phases -- simplify, harden, document, re-verify (in that order)"), each pass has a review checklist, and Pass 4 is a mandatory validation step with a feedback loop ("If verification fails, return to implementation with the diagnostics; do not emit a successful completion") plus budget-exceeded stop conditions — matching the anchor for explicit validation, error-recovery loops, and checklists.

5 / 5

Progressive Disclosure

The single reference file (references/agent-context-snippets.md) exists and is clearly signaled ("Load only the snippet for your active agent to keep context lean"), but a large amount of content that belongs in reference files is inlined in SKILL.md: the ~110-line worked output-schema example, install commands, agent compatibility lists, and integration patterns.

3 / 5

Total

15

/

20

Passed

Description

87%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 with explicit what-and-when structure, concrete pass names, and clean disambiguation from the CI variant. The only weakness is modest trigger-term breadth: natural user phrasings for asking a coding agent to tidy and check its own work are not covered.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("runs simplify, harden, re-verification, and micro-documentation passes") and scopes them to "non-trivial code or high-impact configuration changes", but the pass names are given without what each pass does, leaving minor coverage gaps.

4 / 5

Completeness

It explicitly answers both "what" (four named passes on scoped change types) and "when" ("Use when a task is complete in a general agent session and you want a bounded quality and security sweep before signaling done") with concrete trigger phrasing. A score of 4 would require the "when" clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural trigger phrases like "Use when a task is complete", "before signaling done", "quality and security sweep", and "CI pipeline execution" are present, but common user phrasings such as "review your changes" or "clean up the code before finishing" are missing.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (post-completion self-review sweep) and explicitly disambiguates the adjacent variant ("For CI pipeline execution, use simplify-and-harden-ci"), so risk of triggering the wrong skill is minimal.

5 / 5

Total

18

/

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

skill_md_line_count

SKILL.md is long (571 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

pskoett/pskoett-ai-skills

Path

skills/simplify-and-harden/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.