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

66%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 body delivers a genuinely well-engineered workflow: clearly ordered passes, mandatory re-verification with a failure feedback loop, enforced budgets, and highly concrete checklists and templates. Its weakness is verbosity — philosophical rationale, design-decision justifications, and compatibility lists pad the token budget, and the approval rules are repeated across multiple sections instead of stated once.

Suggestions

Cut or move "Rationale and Philosophy", "Design Decisions", and "Future Considerations" into a separate reference file (or remove them) — they justify the skill to humans rather than instruct the executing agent.

State the refactor-approval and behavior-preserving rules once (e.g., in a short invariants section) and reference that section from the Simplify, Harden, and Integration sections instead of restating them.

Move the full illustrative output schema example to a reference file and keep only the required fields and the review_followup_required rules inline.

DimensionReasoningScore

Conciseness

The 592-line body contains several padded, non-operational sections that explain things Claude already knows or that serve human readers rather than the executing agent: "Rationale and Philosophy", "Design Decisions" ("Agents love to refactor. Given permission to 'improve' code, they will restructure it."), "Future Considerations", a Metadata table, and a 12-agent compatibility list. The refactor-approval rules are also restated across at least four sections (Simplify Actions, Execution Model, Agent Context invariants, Prompt-based Integration), matching anchor 2 (noticeably verbose, several unnecessary explanations or padded sections) rather than anchor 3's mostly-efficient profile.

2 / 5

Actionability

Guidance is mostly executable: concrete checklists ("type coercion issues, missing bounds checks, and unconstrained string lengths"), copy-paste refactor proposal templates, a full output schema example, a configuration block, and a copy-paste prompt-injection integration. Minor gaps keep it at anchor 4 rather than 5: the integration snippet is explicitly generic pseudocode ("context.diff.isNonTrivial()"), and the skip flag is vague ("--no-review or equivalent flag").

4 / 5

Workflow Clarity

The four passes are explicitly sequenced ("Four phases -- simplify, harden, document, re-verify (in that order)"), re-verification is mandatory with a real feedback loop ("If verification fails, return to implementation with the diagnostics; do not emit a successful completion"), budgets are enforced with a budget_exceeded flag, and non-triviality has concrete thresholds (10 changed lines or named high-impact logic changes). This matches anchor 5: clear sequence, explicit validation, feedback loops, and checklists; the destructive/batch cap does not apply since validation is present.

5 / 5

Progressive Disclosure

The body has good section structure and one clearly signaled, one-level-deep reference that exists in the bundle ("Agent-specific copy-paste snippets are in references/agent-context-snippets.md. Load only the snippet for your active agent to keep context lean."). It sits at anchor 4 rather than 5 because substantial content that could live in references is inlined, notably the ~110-line illustrative output schema and the integration examples.

4 / 5

Total

15

/

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 that explicitly covers what the skill does, when to use it, and how it differs from its CI variant. Its main flaws are second-person phrasing in the trigger clause ("you want..."), which costs specificity under this rubric, and some missing natural trigger synonyms like "code review" or "clean up".

Suggestions

Rewrite the trigger clause in third person, e.g., "Use when a task is complete in a general agent session and a bounded quality and security sweep is desired before signaling done."

Add natural trigger synonyms users or agents might say, such as "code review", "clean up the diff", or "harden the code before finishing".

DimensionReasoningScore

Specificity

The description names the domain (post-completion self-review for coding agents) and lists concrete passes ("runs simplify, harden, re-verification, and micro-documentation passes on non-trivial code or high-impact configuration changes"), which fits anchor 4, but the trigger clause uses second person ("you want a bounded quality and security sweep"), and the rubric mandates reducing specificity by 1 for second-person voice, bringing it to anchor 3.

3 / 5

Completeness

It explicitly answers both what ("runs simplify, harden, re-verification, and micro-documentation passes on non-trivial code or high-impact configuration changes") and when ("Use when a task is complete in a general agent session... before signaling done") with concrete trigger phrases, plus a CI boundary redirect, matching anchor 5.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases like "task is complete", "before signaling done", "quality and security sweep", "non-trivial code", and "high-impact configuration changes", though common variations users might say (e.g., "code review", "clean up", "hardening") are missing, matching anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The post-completion self-review niche is clear and the CI sibling is explicitly disambiguated ("For CI pipeline execution, use simplify-and-harden-ci"), but there is minor overlap risk with general code-review or security-review skills, matching anchor 4 rather than the minimal-conflict anchor 5.

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

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

agent-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.