1. Habit
  2. Skills
  3. OpenCLI AutoFix skill
jackwener · 18K installs

OpenCLI AutoFix skill
Runs by itself, opencli command fails.

Broken adapters fixed and retried.

Install the OpenCLI AutoFix skill and make it a habit: follow https://gethabit.dev/skills/jackwener/opencli-autofix.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

18K installs31K starsApache-2.0 licenceSource on GitHub ↗

OpenCLI AutoFix

by jackwener · 18K installs

The skill

The opencli autofix skill repairs broken OpenCLI adapters when a command fails: it collects a trace, patches the adapter, retries, and files an upstream issue after a verified fix.

Only when you ask.

The habit

Broken adapters fixed and retried.

↻ Runs by itselfopencli command fails

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

opencli command fails. Runs in Claude Code.

  • ↻ opencli command fails
  • opencli command exit non-zero

02

It checks its work

retry passes. If a check fails, it tries again.

  • ✓the same opencli command succeeds after the patch
  • ✓verify/<cmd>.json fixtures are not loosened to pass
  • ✓only the file at adapterSourcePath was changed

03

It remembers

repair notes. The next run reads it first: adapters fixed before and the site notes in ~/.opencli/sites/<site>/notes.md.

loops/opencli-autofix-loop/run-log.md

One run, step by step.
Then it stops.

Stop ruleStops after a verified fix, or after 3 repair rounds, or at a hard-stop error.

  1. 01

    Check hard stops

    The agent stops without touching code on AUTH_REQUIRED, BROWSER_CONNECT, captcha or rate limiting.

  2. 02

    Rule out a soft block

    It retries with another query and spot-checks in Chrome, since an empty result is often not an adapter bug.

  3. 03

    Collect the trace

    It reruns with --trace retain-on-failure and reads the summary.md front matter for adapterSourcePath.

  4. 04

    Explore the site

    It uses opencli browser, never the broken adapter, to find the new selector or API.

  5. 05

    Patch minimally

    It edits only the adapter source, keeps the output structure and prefers an API over DOM scraping.

  6. 06

    Verify and file

    It reruns the command, and after a passing retry asks you before filing an upstream GitHub issue.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the OpenCLI AutoFix skill helps.

Use it when

  • ✓ An opencli command fails with a selector or API error
  • ✓ A site changed its DOM or response schema
  • ✓ You want the adapter fixed, not just the error reported

Skip it when

  • – The error is auth, browser connect or captcha
  • – The feature was removed from the site

Questions

OpenCLI AutoFix skill, answered.

Does it ever loosen a test fixture to pass?

No. A failing fixture means the adapter output is broken, so it fixes the adapter instead.

Does it file issues on its own?

No. It shows you the draft and files only after you confirm.

How do I install the OpenCLI AutoFix skill?

Copy the prompt at the top into your agent. It installs the skill from jackwener/OpenCLI and sets up the habit. Or run npx skills add jackwener/OpenCLI --skill opencli-autofix.

Is the OpenCLI AutoFix skill free?

Yes. It is published under Apache-2.0. Habit is free too.

OpenCLI AutoFix. Now as a habit.

Install the OpenCLI AutoFix skill and make it a habit: follow https://gethabit.dev/skills/jackwener/opencli-autofix.md

  • Free
  • No account
  • Undo in one line

All jackwener skills →More code skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by jackwener, published under Apache-2.0. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.