Skip to main content
skill CX Codex

codex-autoresearch-loop — Codex skill: what it does, how to install

Runs an autonomous edit-test-revert loop against measurable repository metrics. It stacks working changes in git and rolls back regressions without manual supervision.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/trending-skills --skill codex-autoresearch-loop -a claude-code
Open on GitHub

What codex-autoresearch-loop does

The skill sets up an automated iterative loop across your code. Before editing anything, the agent probes the repository, identifies the target metric, and prepares two validation steps. You review the inferred plan during an interactive confirmation prompt before execution starts.

Two separate gates validate every step. The verify command ensures the primary metric improves, while the guard command guarantees that unrelated code remains intact. Successful steps stay in git history; failures revert automatically. The loop never modifies files covered by the guard.

Without a defined iteration cap, the loop continues indefinitely until stopped. Discoveries from each step save to lessons.md, allowing subsequent or resumed sessions to avoid previously discarded strategies.

What it helps with

  • eliminate explicit any types throughout TypeScript projects
  • raise test coverage percentages across specified directories
  • resolve failing test suites until all assertions pass
  • diagnose intermittent API errors by testing falsifiable hypotheses

Example prompts for the agent

  • $codex-autoresearch eliminate all any types in TypeScript files
  • $codex-autoresearch fix all failing tests after refactor

How to install codex-autoresearch-loop

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill codex-autoresearch-loop -a claude-code

2Manually: put the files in place

~/.claude/skills/codex-autoresearch-loop/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/codex-autoresearch-loop/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about codex-autoresearch-loop

How to install codex-autoresearch-loop in Codex?

Run npx skills add reason-machines/trending-skills --skill codex-autoresearch-loop -a codex. It installs the skill file into .agents/skills/codex-autoresearch-loop/SKILL.md.

What does codex-autoresearch-loop do?

It runs an unattended loop that makes atomic changes, evaluates them against verification commands, and retains only measurable improvements in git.

What is the difference between verify and guard commands?

The verify command checks whether the target metric got better, triggering a rollback if it did not. The guard command ensures other project parts did not break, allowing up to two repair attempts before reverting.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set139

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor