CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pr-simplify

Simplify your own change to its smallest complete fix. Use before opening a PR, before pushing large repairs to one, or when asked to shrink a PR or clean up slop.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

An exceptionally lean, high-signal instruction skill: policy-level guidance is specific, sequenced, and checkpointed, and validation for batch edits is explicit. The residual gaps are a missing error-recovery loop and slightly monolithic density in the rules section.

DimensionReasoningScore

Conciseness

The body is dense policy prose with no padding and no explanation of concepts Claude already knows — every sentence carries a rule, threshold, or scope decision (e.g., "Count the non-mechanical changed lines. Above about 800, or about 500 for complex logic...").

5 / 5

Actionability

Guidance is concrete and specific — line-count thresholds, the command `git log -p -S <symbol>`, enumerated removal targets like `as any` and mock-echo tests — but as an instruction-only skill it stops short of fully copy-paste-ready commands for the common cases, leaving minor gaps.

4 / 5

Workflow Clarity

Four sequenced sections each ending in an explicit "Done when" checklist, with validation present in step 4 ("rerun the reproduction and focused checks for the changed contracts and affected consumers"), satisfying the batch/destructive validation requirement; however, no explicit error-recovery loop after a failed check, which the top anchor expects.

4 / 5

Progressive Disclosure

A single self-contained file with well-organized, clearly headed sections and no buried or nested references; at roughly 60 lines of dense content it slightly exceeds the under-50-line simple-skill case that would warrant a 5, and the enumerated simplification rules in section 2 are borderline candidates for a separate reference file.

4 / 5

Total

17

/

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 concise, explicit description with strong trigger guidance and a clear what/when pair. Its only weakness is that the single stated action understates the range of concrete behaviors the skill actually covers.

DimensionReasoningScore

Specificity

The description names the domain (simplifying one's own change) and one concrete action — "Simplify your own change to its smallest complete fix" — but does not enumerate the several specific sub-actions the skill performs (architecture removal, test pruning, staged cutting), matching the 1-2-concrete-actions anchor rather than the several-actions anchor.

3 / 5

Completeness

It explicitly answers both what ("Simplify your own change to its smallest complete fix") and when ("Use before opening a PR, before pushing large repairs to one, or when asked to shrink a PR or clean up slop") with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Natural user phrases like "simplify", "before opening a PR", "shrink a PR", "pushing large repairs", and "clean up slop" are present, but common variations such as "trim my diff" or "review my PR" are missing, fitting good-but-not-comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — an author-run editing pass on their own change before PR publication — but "simplify" and "clean up" carry minor overlap risk with general code-review or cleanup skills.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openclaw/openclaw

Path

.agents/skills/pr-simplify/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.