Coding Agent Essentials

A small Codex plugin with practical workflows for understanding, collaborating, reviewing, simplifying, debugging, and testing code. It is intentionally focused: no autonomous development framework, project methodology, or integration bundle.

Install in Codex

Add this repository as a marketplace, then install the plugin:

codex plugin marketplace add lukewilson2002/coding-agent-essentials --ref main
codex plugin add coding-agent-essentials@coding-agent-essentials

Start a new Codex task after installation so the skills are loaded.

Skills

• $simplify-code — asks a read-only specialist to find unnecessary complexity and propose simpler, behavior-preserving implementations; the parent agent validates and applies worthwhile changes.
• $explain — explains concepts and systems with concise examples, Mermaid diagrams, and lightweight HTML visualizations when they materially help.
• $ask-me — interviews you with focused questions and recommended answers until the requirements are mutually understood.
• $interactive — keeps you involved in non-trivial work by aligning on decisions before changes and giving concise milestone updates.
• $adversarial-review — runs a read-only reviewer that tries to disprove correctness and requirement compliance.
• $advanced-review — combines independent simplification, adversarial, and security review lanes, then validates and consolidates their findings.
• $debug-problem — follows an evidence-driven reproduce, isolate, diagnose, fix, and verify loop while respecting diagnosis-only requests.
• $write-tests — adds focused tests of observable behavior rather than implementation details.

Skills may be invoked explicitly or selected automatically by Codex when their descriptions match the request.

Design principles

• Preserve intended behavior unless the user explicitly approves a change.
• Keep specialist reviewers read-only; the parent agent owns edits and verification.
• Prefer evidence over speculation.
• Test public behavior, not internal implementation details.
• Keep explanations and workflows concise.

Repository layout

.agents/plugins/marketplace.json
plugins/coding-agent-essentials/
  .codex-plugin/plugin.json
  skills/

The marketplace manifest points to the plugin using a repository-relative path, allowing Codex to import this GitHub repository directly.

Attribution

The code-simplifier reviewer prompt includes portions adapted from the community Claude plugin by Nick Nisi. See LICENSE.

License

MIT