Efficiency

Help your coding agent do useful work with less unnecessary complexity.

Efficiency is a plugin for Cursor and Codex. 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.

Install from a release

You need Cursor or Codex with plugin support, Node.js 22 or newer, and access to GitHub. You do not need to clone this repository.

Manually

1. Open the latest stable GitHub Release.
2. Download geldmacher-efficiency-cursor-v<version>.zip or geldmacher-efficiency-codex-v<version>.zip for your app, plus SHA256SUMS and provenance.json from the same release. Use the packaged plugin ZIP, not GitHub's Source code archives.
3. Follow the manual installation steps to verify the download, install it, and activate it in your app.

With your agent

Copy this request into Cursor or Codex:

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. Reload Cursor or, once installation is complete in Codex, start a new task.

Update from a release

Manually

Download and verify the latest release for your app, keep the existing installation as a backup, and replace it with the complete new package. Follow the manual update steps, including the reload or refresh required by your app.

With your agent

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.

If the skill is missing, use the installation prompt above. See the installation guide for previews, activation, and recovery.

Try it

Open a project with code changes and ask for a review.

Cursor:

/efficiency Review my current changes for unnecessary complexity.

Codex:

$geldmacher-efficiency:efficiency Review my current changes for unnecessary complexity.

For example, if a change adds a configurable formatter but the project already has a suitable date helper, Efficiency can recommend reusing that helper and explain what needs checking. A review gives recommendations; ask for an implementation when you want changes made.

The usage guide has examples for code reviews, agent instructions, verification, and clearer change summaries. It also covers optional RTK integration, which reduces the terminal output sent to the agent. RTK is not required to use Efficiency.

Learn more

• Usage and examples
• Installation, updates, and recovery
• Contributing and development
• Changelog · Report an issue

MIT · Built by Dennis Geldmacher