GitHub - mertdeveci5/kissingskill

2 min read Original article ↗

Keep it simple, stupid. A skill for coding agents.

npx skills add mertdeveci5/kissingskill

The problem

Both Codex and Claude Code today:

  • Do endless backward compatibility and legacy fallback code, making it impossible to tell if new code is actually running
  • Create unnecessary magic values and .env variables for every experiment
  • Keep patching code until the repo is slop instead of diagnosing issues from the root architectural cause
  • Let CLAUDE.md and AGENTS.md files become bloated or nonexistent

What this skill does

Scans a codebase for CLAUDE.md and AGENTS.md files and injects KISS principles into them:

  • Finds existing files across the repo and smart-merges KISS instructions without altering current content
  • Creates CLAUDE.md and AGENTS.md from templates if they don't exist
  • Adds brief reminders to relevant existing sections (code quality, style, guidelines)
  • Idempotent — running it twice won't duplicate content

What it enforces

  • No legacy fallbacks or backward compatibility shims. Replace, don't layer.
  • No magic values or unnecessary config. Configuration is minimal and intentional.
  • Fix bugs from the root, not the surface. If the design is broken, fix the design.
  • Reduce code before adding more. Bug fixes and enhancements should make code shorter, not longer.
  • Linear code flow. No circular references. Mutually exclusive directories and files.
  • Small failure surface with real error boundaries. Simple does not mean fragile.