sova-simplify
Skill3 starsChanged 5 days agoApache-2.0View on GitHub
Review changed code for reuse, quality, and efficiency, then fix any issues found.
In this repository44 other files it gives its agents.
- AGENTS.mdAGENTS.md
- templates/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- templates/CLAUDE.mdCLAUDE.md
- dashboard-designSkill
- database-patternsSkill
- design-systemSkill
- design-tasteSkill
- issue-templateSkill
- sova-address-prSkill
- sova-after-mergeSkill
- sova-agent-readinessSkill
- sova-audit-instructionsSkill
- sova-debugSkill
- sova-develop-explainSkill
- sova-develop-fullSkill
- sova-developSkill
- sova-extract-knowledgeSkill
- sova-find-taskSkill
- sova-health-auditSkill
- sova-ingest-reviewSkill
- sova-integrate-prSkill
- sova-issueSkill
- sova-new-featureSkill
- sova-optimize-knowledgeSkill
- sova-prSkill
- sova-rearrange-commitsSkill
- sova-researchSkill
- sova-review-fullSkill
- sova-review-prSkill
- sova-reviewSkill
- sova-specSkill
- sova-standupSkill
- sova-statusSkill
- sova-testSkill
- sova-update-docsSkill
- testing-patternsSkill
- visual-auditSkill
- dashboard-designSkill
- database-patternsSkill
- design-tasteSkill
- issue-templateSkill
- testing-patternsSkill
- visual-auditSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 51
If a simplification is risky, skip it.
- Distinctive: line 55
If no simplifications are needed, state that explicitly.
- Distinctive: line 57
If changes were made, summarize:
- Distinctive: line 70
Do NOT reformat code that was not changed in this branch.
- Distinctive: line 71
Do NOT add docstrings, comments, or type annotations to unchanged code.
- Distinctive: line 72
Do NOT create abstractions for fewer than 3 occurrences.
- Distinctive: line 73
Do NOT add error handling for scenarios that cannot happen.
- Distinctive: line 75
NEVER use emojis in any output.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Simplify
Review all changed code for opportunities to reduce complexity, eliminate duplication, and improve quality.
Scope: the arguments provided when this skill is invoked
Instructions
Step 1: Get the Diff Scope
Compare against the fork point with the remote base (three dots), not a local main: two dots against a stale or moved base also lists the base's own newer commits as if this branch made them.
BASE=$(git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null | sed 's#^origin/##')
BASE=${BASE:-main}
git fetch --quiet origin "$BASE"
git diff "origin/$BASE"...HEAD --stat
git diff --cached --stat
git diff --statStep 2: Review Each Changed File
For each changed file, read the entire file and check:
- Code reuse: does new code duplicate existing utilities or helpers? Search the codebase for similar patterns.
- Over-engineering: unnecessary abstractions, premature generalization, excessive configurability for one-time operations.
- Dead code: unused imports, unreachable branches, commented-out code.
- Redundancy: repeated logic that could be a shared helper (only if 3+ occurrences).
- Complexity: can any function be simplified without losing clarity?
- Efficiency: redundant computations, repeated file reads, duplicate API calls.
- Naming: unclear variable or function names that could be more descriptive.
Step 3: Apply Simplifications
Apply each simplification directly. After changes, verify tests still pass, skipping only when an identical check already passed earlier in this autonomous pipeline cycle for this exact worktree state (a no-op outside the autonomous pipeline: sova checks should-skip only ever reports a skip there). Here that can only happen when no simplification was applied, since any edit changes the state the skip is keyed to:
if sova checks should-skip "make check"; then
echo "Full check already passed for this worktree state earlier in the pipeline cycle; skipping re-run."
else
make check && { sova checks record "make check" --passed || true; }
fiIf a simplification is risky, skip it. Only apply safe, clear improvements.
Step 4: Summary
If no simplifications are needed, state that explicitly.
If changes were made, summarize:
## Simplification Summary
**Changes applied**: N
- [brief description of each change]
**Tests**: passingRules
- Do NOT reformat code that was not changed in this branch.
- Do NOT add docstrings, comments, or type annotations to unchanged code.
- Do NOT create abstractions for fewer than 3 occurrences.
- Do NOT add error handling for scenarios that cannot happen.
- Three similar lines of code is better than a premature abstraction.
- NEVER use emojis in any output.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

