Skip to content

JPeetz/agent-skills / skills/development/anti-over-engineering

anti-over-engineering

Verified

Use when AI agents over-engineer code beyond user requests.

FileKindSize
CHANGELOG.mdmarkdown477 B
LICENSEother1.1 KB
SKILL.mdskill md12.0 KB
evals/evals.jsonconfig2.5 KB
references/compatibility.mdmarkdown1.9 KB

evals/evals.json

View on GitHub
{
  "skill": "anti-over-engineering",
  "version": "1.0.0",
  "cases": [
    {
      "id": "e1",
      "description": "Should trigger: agent proposing unnecessary abstraction",
      "input": "Fix the typo in variable name 'usreName' to 'userName'.",
      "shouldTrigger": true,
      "expect": "Only renames the variable, does not refactor the function or add abstraction",
      "assertions": [
        "Only modifies the one line containing the typo",
        "Does not add interfaces, classes, or factories",
        "Does not restructure the file"
      ]
    },
    {
      "id": "e2",
      "description": "Should trigger: excessive scope creep",
      "input": "Add a button that says 'Save' to the profile page.",
      "shouldTrigger": true,
      "expect": "Adds the button only, without animations, accessibility improvements, or styling refactors",
      "assertions": [
        "Adds the button element with minimal markup",
        "Does not rewrite the entire profile page",
        "Does not add CSS framework or animation library"
      ]
    },
    {
      "id": "e3",
      "description": "Should trigger: detecting L4 emergency (total loss of control)",
      "input": "I said just fix the import path. Why did you rewrite the whole module?",
      "shouldTrigger": true,
      "expect": "Recognizes total loss of control, stops, and proposes minimal fix",
      "assertions": [
        "Apologizes and stops all modifications",
        "Re-reads the original request",
        "Proposes a fix with <=10 lines of diff"
      ]
    },
    {
      "id": "e4",
      "description": "Should trigger: rule 2 \u2014 simplest solution first",
      "input": "Refactor this 3-line function into a reusable utility class with dependency injection so it 'scales'.",
      "shouldTrigger": true,
      "expect": "Pushes back and applies the simplest solution (Rule 2)",
      "assertions": [
        "Keeps the 3-line function unless a real need exists",
        "Does not introduce a new file or dependency",
        "Asks what concrete problem the abstraction solves"
      ]
    },
    {
      "id": "n1",
      "description": "Not trigger: user explicitly asks for refactor",
      "input": "Please refactor this module to use a proper service layer.",
      "shouldTrigger": false,
      "expect": "Recognizes explicit user request for abstraction, proceeds normally",
      "assertions": [
        "Does not flag as over-engineering",
        "Proceeds with the refactor as asked"
      ]
    }
  ]
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall