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

75%

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 ./skills/simplify-and-harden/SKILL.md
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 skill body delivers an excellently sequenced, validated workflow with genuinely actionable checklists, but it is noticeably verbose and monolithic: core rules are repeated across sections and secondary material that belongs in reference files is inlined.

Suggestions

State the behavior-preserving vs. approval-required and refactor rules once (in the pass definitions) and reference them from the Execution Model and Prompt-based Integration sections instead of repeating them.

Move the full output-schema example, agent integration code, and configuration block into reference files (e.g., references/output-schema.md, references/integration.md), keeping only the core invariants and pass instructions in SKILL.md.

Cut low-value sections: the Metadata table, the agent-by-agent compatibility list, and Future Considerations add tokens without operational guidance.

DimensionReasoningScore

Conciseness

The 596-line body restates the same approval rules three to four times (Simplify Actions, Execution Model, Prompt-based Integration) and carries padded sections (Metadata table, a twelve-agent compatibility list, Future Considerations, and a ~110-line example output schema), fitting the noticeably-verbose anchor with several padded sections.

2 / 5

Actionability

Guidance is mostly executable: concrete checklists naming specific vectors (SQL injection, XSS, path traversal, TOCTOU), explicit change categorization rules, a worked refactor-proposal prompt, a full YAML output schema, and a config example, with only minor gaps such as the illustrative integration pseudocode.

4 / 5

Workflow Clarity

The four passes are clearly sequenced with trigger conditions, scope lock, and budget caps, and Pass 4 provides explicit validation (re-run smallest covering checks), an error-recovery feedback loop ("If verification fails, return to implementation"), and a defined not-run path — matching the top anchor.

5 / 5

Progressive Disclosure

Section headers are clear and the one bundle reference (references/agent-context-snippets.md) is well signaled and one level deep with load-only-your-snippet guidance, but large content that belongs in separate reference files (integration code, configuration, full output schema, design rationale) is inlined in the 596-line body.

3 / 5

Total

14

/

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, when, and scope with good trigger keywords and clean separation from its CI sibling. The only notable flaw is second-person voice ("you want"), which the rubric penalizes on specificity.

Suggestions

Rewrite in third person to remove the second-person clause, e.g., "Use when a coding task is complete in a general agent session and a bounded quality and security sweep is wanted before signaling done."

Add one or two natural trigger synonyms users would actually say, such as "review changes before finishing" or "clean up code before done".

DimensionReasoningScore

Specificity

The description lists several concrete actions ("runs simplify, harden, re-verification, and micro-documentation passes on non-trivial code or high-impact configuration changes"), which fits the several-specific-actions anchor, but the second-person phrasing "you want a bounded quality and security sweep" triggers the rubric's mandatory 1-point penalty, landing it at the domain-plus-actions level.

3 / 5

Completeness

It clearly answers what ("Post-completion self-review ... runs simplify, harden, re-verification, and micro-documentation passes") and explicitly when ("Use when a task is complete in a general agent session ... before signaling done"), with concrete trigger phrasing and CI-variant disambiguation.

5 / 5

Trigger Term Quality

Good natural keyword coverage including "task is complete", "self-review", "quality and security sweep", "before signaling done", and the pass names, though common variations users might say such as "code review", "review my changes", or "clean up" are missing.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear post-completion self-review niche and explicitly routes CI pipeline use to a sibling skill ("For CI pipeline execution, use simplify-and-harden-ci"), leaving only minor overlap risk with generic code-review or cleanup skills.

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

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.