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.

70

Quality

88%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 highly actionable, well-sequenced workflow with explicit validation loops, concrete thresholds, and a clean one-level-deep reference. Its main weakness is token efficiency: core invariants are restated across four overlapping sections and a very long inline output-schema example inflates the file.

Suggestions

Consolidate 'Agent Context File References', 'Execution Model', 'Agent Compatibility', and 'Integration Notes' into a single section — they restate the same scope-lock/budget/approval rules three to four times.

Move the 110-line example output schema into a reference file (e.g. references/output-schema-example.md) and keep only the field summary plus review_followup_required semantics inline.

Trim 'Rationale and Philosophy' and 'Future Considerations' to a few lines each — they read as design prose rather than instructions the agent executes.

DimensionReasoningScore

Conciseness

Most sections carry operational rules Claude would not infer (budget caps, approval gates, checklists), but the ~570-line body repeats its core invariants across 'Agent Context File References', 'Execution Model', 'Agent Compatibility', and 'Integration Notes', and the 110-line example output schema plus 'Future Considerations' padding could be tightened. Not 4: the redundancy is more than 'minor instances' — the same simplify/harden/approval rules are stated three to four times; not 2: the verbosity is repetition of genuinely needed bespoke rules, not explanation of concepts Claude already knows.

3 / 5

Actionability

Guidance is fully executable: concrete checklists per pass, numeric budgets (20% diff cap, 60s, max 5 comments), categorization decision rules, a copy-paste-ready post-task prompt block, a complete config YAML, and worked proposal examples. Not 4: the main-use-case artifacts (prompt injection block, configuration) are directly usable with no significant gaps; the generic integration snippet is explicitly labeled as adaptable rather than pseudocode masquerading as runnable code.

5 / 5

Workflow Clarity

The four passes are explicitly sequenced ('simplify, harden, document, re-verify (in that order)') with checklists, and Pass 4 is a real validation loop: re-run the smallest covering checks, and 'If verification fails, return to implementation with the diagnostics; do not emit a successful completion'. Not 4: checkpoints are explicit and the error-recovery feedback loop is stated, matching the top anchor rather than leaving minor validation gaps.

5 / 5

Progressive Disclosure

The single reference (references/agent-context-snippets.md) is real, well-signaled ('Load only the snippet for your active agent to keep context lean'), and exactly one level deep with per-agent sections. Not 5: the body itself is not a lean overview — the 110-line output-schema example, agent compatibility name-drops, and integration snippets that duplicate the reference file are inlined where a 5 would split them out.

4 / 5

Total

17

/

20

Passed

Description

92%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: third-person, explicit 'Use when' trigger with concrete phrases, all four passes named, and an explicit boundary routing CI usage to a sibling skill. The only weakness is modest keyword coverage — a few natural user phrasings ('review my changes', 'cleanup before done') are missing.

DimensionReasoningScore

Specificity

The description lists four concrete named passes — "runs simplify, harden, re-verification, and micro-documentation passes" — and scopes them to "non-trivial code or high-impact configuration changes", giving comprehensive coverage of the skill's actions in third-person voice. Not 4: unlike 'minor gaps in coverage', every operational pass of the skill is named, with scope qualifiers.

5 / 5

Completeness

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...") are explicitly answered with concrete trigger phrases, plus a boundary clause routing CI usage to the sibling skill. Not 4: the 'when' clause is already explicit and specific, not merely present with room for improvement.

5 / 5

Trigger Term Quality

Natural phrases like "Use when a task is complete", "self-review", and "a bounded quality and security sweep before signaling done" are terms a user would plausibly say. Not 5: common variations such as 'review my changes', 'cleanup before finishing', or 'code review' are absent, so a few natural terms are missing.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (post-completion, bounded, self-review before signaling done) and explicitly disambiguates from the CI variant ("For CI pipeline execution, use simplify-and-harden-ci"), minimizing conflict risk. Not 4: the trigger conditions are distinct enough that overlap with generic code-review skills is minimal, not just 'minor'.

5 / 5

Total

19

/

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

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