opencli-autofix
Automatically fix broken OpenCLI adapters when commands fail. Load this skill when an opencli command fails — it guides you through diagnosing the failure via OPENCLI_DIAGNOSTIC, patching the adapter, retrying, and filing an upstream GitHub issue after a verified fix. Works with any AI agent.
Best for OpenCLI users encountering…Works with GitHub
⌘source
- author
@jackwener- language
- JavaScript
★16kstars
1.6kforks
Apr 18, 2026
✦overview.md
Key Features
- ·Automatically diagnoses and fixes broken OpenCLI adapters
- ·Guides through diagnostic, patch, retry, and issue filing workflow
- ·Works with any AI agent
- ·Enforces safety boundaries and scope constraints
- ·Limits repair attempts to 3 rounds per failure
Use Cases
- →An opencli command fails due to website DOM, API, or schema changes
- →You need to quickly patch an adapter and retry a command without manual debugging
- →You want to file an upstream GitHub issue after verifying a fix
Best for
- ✓OpenCLI users encountering adapter failures
- ✓Automated workflows requiring CLI tool resilience
Not ideal for
- !Authentication failures (AUTHREQUIRED)
- !Browser connection issues (BROWSERCONNECT)
- !CAPTCHA or rate limiting problems
FAQs
name
opencli-autofix
description
Automatically fix broken OpenCLI adapters when commands fail. Load this skill when an opencli command fails — it guides you through diagnosing the failure via OPENCLI_DIAGNOSTIC, patching the adapter, retrying, and filing an upstream GitHub issue after a verified fix. Works with any AI agent.
allowed-tools:Bash(opencli:*), Bash(gh:*), Read, Edit, Write
OpenCLI AutoFix — Automatic Adapter Self-Repair
When an opencli command fails because a website changed its DOM, API, or response schema, automatically diagnose, fix the adapter, and retry — don't just report the error.
Safety Boundaries
Before starting any repair, check these hard stops:
AUTH_REQUIRED(exit code 77) — STOP. Do not modify code. Tell the user to log into the site in Chrome.BROWSER_CONNECT(exit code 69) — STOP. Do not modify code. Tell the user to runopencli doctor.- CAPTCHA / rate limiting — STOP. Not an adapter issue.
Scope constraint:
- Only modify the file at
RepairContext.adapter.sourcePath— this is the authoritative adapter location (may beclis/<site>/in repo or~/.opencli/clis/<site>/for npm installs) - Never modify
src/,extension/,tests/,package.json, ortsconfig.json
Retry budget: Max 3 repair rounds per failure. If 3 rounds of diagnose → fix → retry don't resolve it, stop and report what was tried.
Prerequisites
opencli doctor # Verify extension + daemon connectivity
When to Use This Skill
$install
1-click copynpx skills add jackwener/OpenCLI --skill opencli-autofixSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.