code-simplify

A code-cleanup guide that makes existing code easier to read while preserving exactly what it does.

In plain words
What is it for?
Use it to simplify functions, clarify variables, remove dead code, and reduce unnecessary parameters after a feature or bug fix.
Why use it?
It reduces duplication, deep nesting, unclear names, unused code, and overly complicated expressions without changing behavior or public interfaces.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/ayushparkara/syntra/code-simplify
Any agent
npx skills add AyushParkara/syntra --skill code-simplify
Clone the repo
git clone --depth 1 https://github.com/AyushParkara/syntra

Made for: Claude Code, Codex.

Per session 32 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 266 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00032 $0.00266
Opus 5 $0.00016 $0.00133
Sonnet 5 $0.00006 $0.00053
Haiku 4.5 $0.00003 $0.00027

Measured 2d ago against content hash 90736fb8d0ab, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

code-simplify scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

syntra/skills/code-simplify/SKILL.md · 24 lines

What it actually says

You simplify code. The behavior must stay identical — this is cleanup only, not a rewrite.

What to improve (in priority order):

  1. Remove duplication — extract repeated logic into one shared function.
  2. Flatten nesting — replace deep if/else pyramids with early returns/guards.
  3. Clarify names — rename cryptic variables/functions to say what they are.
  4. Delete dead code — unused vars, unreachable branches, commented-out cruft.
  5. Simplify expressions — collapse redundant booleans, ternaries, conversions.
  6. Reduce surface — fewer params, smaller functions doing one thing.

Hard rules:

  • NEVER change observable behavior. Same inputs → same outputs, same side effects.
  • Don't add features, don't "improve" logic, don't change public APIs.
  • If a simplification would alter behavior, STOP and flag it instead of doing it.
  • Prefer the smallest set of changes that meaningfully improves clarity.

Output: Show before/after for each change and state what got simpler and why.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 24 lines · 32 tokens per session scan A 90736fb8d0ab

Subscribe to this mod's changes

code-simplify is a skill published in the GitHub repository AyushParkara/syntra (5 stars, last pushed 22d ago), licensed Apache-2.0. It adds 32 tokens to every session and 266 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

speq-plan-pr

Headless, non-interactive version of /speq-plan for CI or agent-driven runs. Plans a feature without a live interview, commits the result to a feat/plan-name branch, and opens a draft PR. If a decision genuinely needs a human, it persists the partial plan and open questions and asks in a PR comment instead of…

marconae/speq-skill · 91 tokens

speq-implement

Orchestrate implementation of a reviewed plan: task breakdown, TDD sub-agents, code review, and verification report. Use when the user asks to implement, build, or execute a plan under specs/plans/ — after /speq-plan, before /speq-record. Arg: .

marconae/speq-skill · 68 tokens

speq-audit

Audit a speq project's health — spec-library structure, feature/decision-log/plan validation, mission-to-spec sync, unrecorded plans, and gitignore hygiene — then guide fixes. Use when the user asks to audit, health-check, doctor, lint, or sanity-check the specs or repo, or after cloning or inheriting a speq project.

marconae/speq-skill · 77 tokens

speq-code-review

Code review tag taxonomy and findings output format — guardrail violations, dead code, test quality, bad comments, optimizations, YAGNI/over-engineering, error handling, and design depth. Triggered by code-reviewer.

marconae/speq-skill · 52 tokens

speq-implement-pr

Headless follow-up to /speq-plan-pr. Continues on a plan's feat/plan-name branch, runs /speq-implement, bumps the version, runs the real test suites, records only if green, then pushes, opens/updates the PR, and marks it ready. Arg: plan name, PR number, or branch name.

marconae/speq-skill · 77 tokens

speq-plan

Plan a feature or change through a clarifying interview, producing spec deltas, plan.md, and decision-log.md via planner-agent with adversarial review. Use when the user asks to plan, spec, design, or scope a new feature, a change or removal of existing behavior, a refactor, or a fix — before any implementation.

marconae/speq-skill · 73 tokens