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.

62

Quality

78%

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

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 body delivers an exceptionally clear, actionable four-pass workflow with real validation and feedback loops, but it pays for that with significant token bloat: repeated rule statements across sections, an overlong example schema, and padded compatibility/future sections. Moving bulk material into reference files and deduplicating the repeated pass rules would raise both conciseness and progressive disclosure without losing actionability.

Suggestions

Move the ~110-line example output schema, the 'Design Decisions' rationale, and the 'Agent Compatibility' roster into a references/ file (e.g. references/output-schema.md and references/compatibility.md), keeping only a compact schema skeleton and a one-line pointer in SKILL.md.

Deduplicate the pass rules: the Simplify/Harden action categories and stop-hook rules are stated in the pass sections, restated in 'Prompt-based Integration', and summarized again in 'Core invariants' — keep one authoritative statement and reference it.

Cut the 'Future Considerations' section and the twelve-agent name list to a single sentence ('works with any agent exposing a task-completion lifecycle event'), which is the one fact that matters.

DimensionReasoningScore

Conciseness

Noticeably verbose with several padded or duplicated sections: the Simplify pass rules are restated nearly verbatim in 'Prompt-based Integration' and again in the 'Core invariants' list; the Refactor Stop Hook is described in full in both the Simplify and Harden passes; the 'Agent Compatibility' section name-drops a dozen agents; 'Future Considerations' is speculative; and the example output schema alone spans roughly 110 lines. The material is instructions rather than concept explanations Claude already knows, which keeps it above the lowest anchor, but the body is several times longer than the procedure requires.

2 / 5

Actionability

Fully executable guidance throughout: concrete checklists ('Check for SQL injection, XSS, command injection, path traversal, and template injection in any code that builds strings from external input'), explicit finding-categorization rules with approval gates, a copy-paste-ready prompt-injection block, example approval-prompt transcripts, and a complete configuration example. A precise non-trivial-diff definition (10 changed lines or listed high-impact categories) leaves no ambiguity about what to do.

5 / 5

Workflow Clarity

The four passes are explicitly ordered ('Four phases -- simplify, harden, document, re-verify (in that order)') with trigger conditions, scope locks, and budget limits up front, and Pass 4 is a mandatory validation step with a failure feedback loop: 'If verification fails, return to implementation with the diagnostics; do not emit a successful completion.' Error-recovery paths (budget_exceeded, skip-all refactors, not-run verification) are all addressed.

5 / 5

Progressive Disclosure

The single reference (references/agent-context-snippets.md) exists, is clearly signaled, and is one level deep with its own table of contents, but substantial content that belongs in separate reference files is inlined in SKILL.md: the ~110-line example output schema, the 'Design Decisions' rationale, and the agent-compatibility roster. Structure is present and sections are navigable, but the split between overview and detailed material is only partial.

3 / 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 with an explicit what/when pair, concrete pass names, and good CI-variant disambiguation. Its weaknesses are the second-person voice in the trigger clause (which costs it specificity points under the rubric) and somewhat thin coverage of natural trigger synonyms.

Suggestions

Rewrite the trigger clause in third person to avoid the specificity penalty, 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.'

Broaden trigger vocabulary with natural synonyms users would say, such as 'self-review', 'code review before done', 'cleanup pass', or 'before committing'.

Mention one or two more concrete capabilities (e.g. the structured summary output or budget-capped edits) to lift specificity coverage toward comprehensive.

DimensionReasoningScore

Specificity

Base score 4: the description lists several concrete actions ('runs simplify, harden, re-verification, and micro-documentation passes on non-trivial code or high-impact configuration changes') with minor coverage gaps (the structured output and learning loop are unmentioned). The second-person phrase 'you want a bounded quality and security sweep' violates the third-person voice rule, applying the mandated 1-point penalty, reducing this to 3.

3 / 5

Completeness

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... before signaling done') with concrete trigger phrases, plus a disambiguating pointer to the CI variant.

5 / 5

Trigger Term Quality

Good natural trigger coverage: 'Use when a task is complete', 'quality and security sweep', 'before signaling done' are phrases a user or agent would plausibly say. A few common variations are missing, such as 'code review', 'cleanup', or 'before committing'.

4 / 5

Distinctiveness Conflict Risk

'Post-completion self-review' carves a clear niche with distinct timing-based triggers, and the explicit CI-variant boundary aids disambiguation. Minor overlap risk remains with generic code-review and security-review skills, so it falls just short of the 'clear niche, minimal conflict' anchor.

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 (571 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.