A high-speed, surgical repair protocol for AI agents to fix small bugs and typos with minimal tool interaction.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install shadows-oneshot-fix
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install shadows-oneshot-fix using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Oneshot Fix (Surgical Quick Fix)?
Oneshot Fix is a specialized protocol designed for Openclaw Skills that prioritizes speed and precision over deep exploration. It is engineered for scenarios where the root cause of a bug is already known or the change is trivial, such as fixing a typo, updating a configuration value, or correcting a simple naming error. By strictly limiting the agent to five tool calls, it prevents common AI pitfalls like over-engineering or unnecessary file exploration.
This skill ensures that your AI coding assistant stays focused on the task at hand without wandering into architectural discussions or broad refactoring. It provides a tight read-diagnose-fix-verify cycle that is perfect for maintaining high velocity in active development environments where small, iterative improvements are frequent.
Oneshot Fix (Surgical Quick Fix) Use Cases
- Resolving small, clearly-defined bugs with a known file location.
- Correcting simple syntax typos or naming inconsistencies across the codebase.
- Implementing rapid configuration tweaks or environment variable changes.
- Executing single-file changes where the solution is obvious and requires no brainstorming.
- Responding to user prompts like quick fix, oneshot, or just fix it within the context of Openclaw Skills.
How Oneshot Fix (Surgical Quick Fix) Works
- READ: The agent performs a single tool call to read the target file or a specific line range if specified.
- DIAGNOSE: A mental-only analysis phase where the agent determines the minimal fix required without additional tool calls.
- FIX: The agent applies the fix using the Edit tool, strictly adhering to the existing coding style and avoiding any extra refactoring.
- VERIFY: A final tool call runs a language-specific syntax check or targeted test to ensure the fix is valid.
Oneshot Fix (Surgical Quick Fix) Setup
The Oneshot Fix skill relies on standard development utilities to perform verification. Ensure the following are available in your environment:
# For Python syntax verification
python -m py_compile <filename>
# For TypeScript type checking
npx tsc --noEmit <filename>
# For running tests (optional)
pytest <test_file> # or jest/vitest
No additional binary installation is required for the core logic, as Openclaw Skills utilize your existing local toolchain for verification.
Oneshot Fix (Surgical Quick Fix) Data Schema & Taxonomy
Oneshot Fix operates on existing repository files and generates minimal metadata. It does not create new files. The output structure follows a rigid schema for clarity:
| Field | Description |
|---|---|
| Fixed | A one-line description of the resolved issue. |
| File | The file path and line number modified. |
| Change | A representation of the old versus new code snippet. |
| Verified | The outcome of the compilation or test run. |
Oneshot Fix (Surgical Quick Fix) Advanced Features
- Automatic tool detection: Dynamically identifies if Python or Node.js compilers are available for verification.
- Graceful degradation: Skips the verification step if no compatible compilers are found, providing a manual verification recommendation.
- Constraint enforcement: Hard limit of 5 tool calls to prevent agent hallucination loops or excessive resource usage.
- Minimal diff generation: Specifically designed to touch only the necessary lines, preserving the integrity of surrounding code within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
MCP Forge
A specialized tool for building Model Context Protocol (MCP) servers in Python or TypeScript to connect external services with AI agents.
Doc Forge
Doc Forge is an intelligent documentation engine that analyzes source code to generate professional READMEs, API references, and architectural overviews.
Deploy Guardian
An automated 6-gate verification system designed to validate code health and security before any production or staging deployment.
Deep Research Protocol
A rigorous 4-round reasoning protocol designed to guide AI agents through exhaustive landscape mapping, risk assessment, and strategic synthesis.
Project Architect
A professional-grade planning protocol that guides AI agents through requirements analysis, architecture design, and actionable task mapping.
Python Sensei
A specialized AI coding assistant that enforces strict Python engineering standards, including type safety, async patterns, and modular architecture.
Featured*
