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.

61

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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 body delivers an exceptionally clear, well-validated four-pass workflow with concrete triggers and approval gates, but at roughly three times the necessary length: core rules are repeated across four-plus sections and large integration/design material is inlined in SKILL.md instead of being split into reference files.

Suggestions

State each core rule (scope lock, 20% budget, refactor approval, four-phase order) exactly once and reference it from elsewhere; drop the Metadata table, install commands, agent compatibility list, and Future Considerations, which add no executable guidance.

Move the ~110-line example Output Schema, Integration Notes, Configuration, and Design Decisions sections into references/ files (e.g., references/output-schema.md, references/integration.md) linked from a short SKILL.md overview, matching the pattern already used for agent-context-snippets.md.

Trim the full worked Output Schema example down to a minimal skeleton showing the required fields, keeping the detailed per-finding examples in a reference file.

DimensionReasoningScore

Conciseness

The ~565-line body restates its core rules four or more times — "Only touch files modified in this task" and "refactor requires approval" each appear in Scope Constraints, the Core invariants list, the Prompt-based Integration block, and the configuration example — alongside padded sections Claude does not need to execute the skill (Metadata table, install commands, a ~110-line example Output Schema, a 12-agent compatibility list, Design Decisions, Future Considerations). This matches anchor 2 (noticeably verbose, several padded sections) rather than 3 (could merely be tightened).

2 / 5

Actionability

Guidance is largely executable: quantified trigger conditions ("At least 10 changed non-comment, non-whitespace lines"), per-pass checklists, verbatim approval-gate dialogue examples, a copy-paste prompt-injection block, a complete config example, and a fully specified output schema. Not 5 because the agent.on('task:complete') integration snippet is explicitly illustrative pseudocode rather than runnable code.

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 an error 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 each pass has a checklist — matching the anchor-5 example (clear sequence, explicit validation, feedback loops, checklists).

5 / 5

Progressive Disclosure

The one bundle reference is real, clearly signaled, and one level deep ("Agent-specific copy-paste snippets are in references/agent-context-snippets.md. Load only the snippet for your active agent"), but the main body inlines large chunks that belong in separate reference files — the ~110-line Output Schema example, Integration Notes, Configuration, and Design Decisions. This fits anchor 3 (content that should be separate is inline) rather than 4 (placement not mostly appropriate), and is above 2 because structure and reference signaling are present.

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 names the domain and four concrete passes, gives an explicit 'Use when...' trigger tied to task completion, and cleanly routes CI usage to a sibling skill. The only deductions are second-person voice in the trigger clause and a few missing natural synonyms.

DimensionReasoningScore

Specificity

Lists four concrete actions ("runs simplify, harden, re-verification, and micro-documentation passes") with a clear scope ("non-trivial code or high-impact configuration changes"), which is anchor-5 coverage; however, the second-person phrasing "when... you want a bounded quality and security sweep" triggers the rubric's third-person voice penalty of 1 on specificity.

4 / 5

Completeness

Explicitly answers both what ("runs simplify, harden, re-verification, and micro-documentation passes") and when ("Use when a task is complete in a general agent session... before signaling done"), with concrete trigger phrasing plus a routing clause to the CI variant. Matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage — "task is complete", "before signaling done", "quality and security sweep", "non-trivial code", "configuration changes" — but a few natural user phrasings are missing (e.g., "review my changes", "clean up the code"). Clearly above anchor 3 since coverage is solid rather than partial.

4 / 5

Distinctiveness Conflict Risk

Clear niche (post-completion self-review for coding agents) that is explicitly disambiguated from the CI variant ("For CI pipeline execution, use simplify-and-harden-ci"), leaving only minor overlap risk with generic code-review/simplify skills on terms like "simplify" and "harden".

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