Help your coding agent do useful work with less unnecessary complexity.
Efficiency is a plugin for Cursor, Codex, and OpenCode 2.1.2. It gives your agent guidance to:
- Keep code easier to maintain: reuse what your project already provides and avoid abstractions the task does not need.
- Keep instructions easier to manage: find duplicated or misplaced guidance in files such as
AGENTS.md, rules, and skills. - Make results easier to act on: explain what changed, what was checked, and what you need to do next.
Use the installation request below or follow the manual installation steps. Complete your app's activation steps: reload Cursor or, after installation is complete in Codex, start a new task.
- Cursor: the plugin's short rule for clear responses and simple, in-scope code changes applies automatically.
- Codex: equivalent guidance across projects is an optional, separate setup. Plugin installation alone does not configure it. You can use the skills without this setup.
To check or preview the Codex setup, copy this request:
$geldmacher-efficiency:response-simplicity-setup Show the current status and preview setup of persistent response guidance. Do not change configuration.
The preview shows the proposed change to your global instructions. To configure it, approve the displayed patch and request that it be applied, then start a new task. See setup and removal.
Open a project with code changes and ask:
Cursor:
/efficiency Review my current changes for unnecessary complexity.
Codex:
$geldmacher-efficiency:efficiency Review my current changes for unnecessary complexity.
OpenCode:
@efficiency Review my current changes for unnecessary complexity.
/efficiency sends the same request. OpenCode lists the skill for automatic selection as well.
You get recommendations tied to the requirement and the code; files stay unchanged. For example, Efficiency may suggest reusing an existing date helper instead of adding a configurable formatter. To make a change, request the selected recommendation and its scope. See review and implementation examples.
Give your agent the task you want completed. In Cursor, or once the optional Codex guidance is configured, the short rule accompanies ordinary work. Call a skill when you need a focused review, assessment, or change text; ordinary tasks need no separate efficiency report.
| Situation | Recommended use |
|---|---|
| An ordinary development task | Describe the required change and its scope as usual. |
| A change seems unnecessarily complex | Ask efficiency for a focused review. |
| Effort or useful checks are unclear | Ask efficiency to assess the work or plan verification. |
| Project instructions are hard to follow | Ask context-optimization to review the instructions. |
| Terminal output is extensive | Optionally ask rtk-setup to check RTK integration. |
The usage guide has copyable requests for both apps, expected results, and next steps. Efficiency keeps agreed requirements and necessary checks intact. Optional RTK reduces terminal output; that alone does not establish lower total task cost.
You need Cursor, Codex, or OpenCode 2.1.2 with plugin support, Node.js 22 or newer, and access to GitHub. You do not need to clone this repository. OpenCode support is @opencode/cli 2.1.2, not the opencode-ai 1.x package.
Copy this request into Cursor, Codex, or OpenCode:
Install the latest stable Efficiency release from
https://github.com/geldmacher/efficiency for my current app.
Follow https://github.com/geldmacher/efficiency/blob/main/docs/installation.md,
section "First installation without the skill".
Verify the release before installing and tell me whether a reload or new task is needed.
Your agent downloads and verifies the release, installs it for your app, and reports any remaining activation step. For a manual installation, use the latest stable GitHub Release and follow the verification and installation procedure.
Use the installed update skill:
Cursor:
/install-new-release-from-repo Update Efficiency to the latest stable GitHub Release for Cursor.
Codex:
$geldmacher-efficiency:install-new-release-from-repo Update Efficiency to the latest stable GitHub Release for Codex.
OpenCode:
@install-new-release-from-repo Update Efficiency to the latest stable GitHub Release for OpenCode.
If the skill is missing, use the installation request above. For manual updates, follow the replacement and activation steps. The installation guide also covers previews and recovery.
- Usage and examples
- Installation, updates, and recovery
- Contributing and development
- Changelog · Report an issue
MIT · Built by Dennis Geldmacher