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.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./plugin/skills/simplify-and-harden/SKILL.md

The canonical home for this skill is simplify-and-harden in pskoett/pskoett-ai-skills

SKILL.md
Quality
Evals
Security

Quality

Content

62%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 core workflow is excellent: clearly sequenced passes, explicit validation with failure recovery, and concrete approval gates and budgets. The body is dragged down by token inefficiency -- duplicated rationale and integration sections, repeated rules, and a huge inlined output-schema example that should live in a reference file.

Suggestions

Move the full sample output schema, agent integration code, and configuration templates into files under references/ (e.g., references/output-schema.md, references/integration.md) and keep only the key fields and invariants inline, which would cut the body roughly in half.

Consolidate "Agent Compatibility", "Integration Notes" (Agent Integration / Prompt-based Integration), and "Agent Context File References" into a single integration section -- they repeat the same agent-agnostic message three times.

Merge "Rationale and Philosophy" with "Design Decisions", drop the Metadata table, and state the refactor-requires-approval rule once as a core invariant instead of restating it in five places.

DimensionReasoningScore

Conciseness

The 596-line body is noticeably verbose: "Rationale and Philosophy" and "Design Decisions" cover the same ground, agent-integration guidance is restated across "Agent Compatibility", "Integration Notes/Agent Integration", and "Prompt-based Integration", the refactor-approval rule is repeated in 5+ places ("refactor_requires_approval: true # ALWAYS true -- cannot be disabled"), a ~110-line sample output YAML is inlined, and the Metadata table adds no operational value.

2 / 5

Actionability

Concrete thresholds ("At least 10 changed non-comment, non-whitespace lines", "Maximum: 5 comments added per task", "20% max additional diff"), copy-paste refactor/security proposal templates, config YAML, and a prompt-injection block make the guidance mostly executable; not 5 because external hooks "verify-gate" and "self-improvement" are referenced without being defined.

4 / 5

Workflow Clarity

The four passes are explicitly sequenced ("Four phases -- simplify, harden, document, re-verify (in that order)"), each pass has a checklist, and re-verification is mandatory with a true feedback loop ("If verification fails, return to implementation with the diagnostics; do not emit a successful completion") plus explicit not-run handling.

5 / 5

Progressive Disclosure

The single bundle reference is clearly signaled with lean-loading guidance ("Agent-specific copy-paste snippets are in references/agent-context-snippets.md. Load only the snippet for your active agent"), but content that clearly belongs in separate files -- the full sample output schema, integration code, and config templates -- is inlined in a 596-line body.

3 / 5

Total

14

/

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: it states concrete capabilities in third person, gives an explicit and natural 'Use when' trigger, and cleanly scopes the CI variant. The only room for improvement is unpacking the pass names into their concrete actions and covering a few more natural user phrasings.

DimensionReasoningScore

Specificity

"runs simplify, harden, re-verification, and micro-documentation passes on non-trivial code or high-impact configuration changes" lists several specific operations on a defined target in third person; not 5 because the passes are named at a summary level rather than comprehensively describing what each does.

4 / 5

Completeness

It explicitly answers both: what ("Post-completion self-review for coding agents that runs simplify, harden, re-verification, and micro-documentation passes") 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, matching the top anchor.

5 / 5

Trigger Term Quality

Natural phrases like "task is complete", "before signaling done", and "quality and security sweep" give good keyword coverage; a few natural user variations (e.g., "review your work", "clean up before finishing") are missing, so it fits anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The post-completion timing plus the four-pass structure carve out a clear niche with distinct triggers and CI-variant disambiguation; minor overlap risk remains with closely related general code-review and simplify skills, so it fits anchor 4 rather than 5.

4 / 5

Total

17

/

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 (597 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

pskoett/pskoett-ai-skills

Path

plugin/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.