simple-code

Cross-language software design guidance for code that needs to stay understandable under change.

simple-code helps agents reduce incidental complexity when writing, reviewing, refactoring, or structuring code. It favors concrete, local, reversible solutions over speculative abstraction.

Install

npx skills add https://github.com/MylesMCook/simple-code --skill simple-code

What It Covers

• API and interface design
• Module boundaries and layering
• Refactoring and incremental migration
• Testing at stable boundaries
• Error handling and naming

What It Does Not Try To Override

simple-code is a maintainability skill, not a replacement for security, compliance, accessibility, formal verification, or specialized performance guidance when those concerns dominate the decision.

Repository Layout

• SKILL.md - the skill itself
• references/ - focused supporting guidance
• evals/ - prompt sets for trigger and behavior checks

License

MIT