add-driver

Scaffold and verify a new loop-generator agent backend driver against the conformance harness.

1|1|Updated Jun 27, 2026
One-click install
npx skills add https://github.com/ShortStackEngineer/loop-generator --skill add-driver-shortstackengineer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-driver
Source: https://github.com/ShortStackEngineer/loop-generator/tree/main/.claude/skills/add-driver
Command: npx skills add https://github.com/ShortStackEngineer/loop-generator --skill add-driver-shortstackengineer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires zod, and includes references (resource) components.

What problem does it solve? Adding a new coding agent backend (Codex, Aider, Cursor, etc.) to loop-generator requires implementing the AgentDriver contract correctly — confining edits to the workspace, honoring abort signals, applying feedback, and classifying stop reasons honestly. This Skill guides that work as a feedback loop: scaffold the driver, register it, then iterate on loopgen verify-driver <name> until all four conformance scenarios pass. ## Core Features & Use Cases - Backend classification: Determines whether the target is an agentic CLI, an agentic SDK, or a model server, and routes model servers (LM Studio, Ollama, OpenAI-compatible) to the existing opencode driver instead of writing a new one. - Conformance-driven loop: Maps each failing scenario (reports-name, creates-file, applies-feedback, honors-abort) to a concrete fix, repeating until verify-driver reports PASS. - Copy-paste skeletons: Provides a subprocess CLI skeleton and a model-server skeleton, plus registration, preflight helpers, and test-seam patterns so unit tests never hit the network. - Use Case: A user wants to integrate the Aider CLI as a loop-generator backend. The Skill scaffolds src/drivers/aider.ts from the CLI skeleton, registers it in src/registry.ts, then drives verify-driver aider to green one scenario at a time. ## Quick Start Ask the agent to add a new loop-generator driver for your chosen agentic CLI or SDK and drive it to green with the verify-driver conformance harness.

Frequently Asked Questions about add-driver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new agent backend to loop-generator?

Implement the AgentDriver contract (name, preflight, run) in src/drivers/<name>.ts using the closest skeleton, register it in src/registry.ts, then run npm run loopgen -- verify-driver <name> and fix one failing scenario at a time until it passes.

Should I write a new driver for LM Studio or Ollama?

No. LM Studio, Ollama, and other OpenAI-compatible endpoints are model servers without filesystem or tool access. Point the existing opencode driver at them with model: lmstudio/<id> or ollama/<id> instead of writing a new driver.

Why does the creates-file conformance scenario fail?

It fails when the driver does not write OUTPUT.txt under inv.workdir, or when the file contents include extra text like markdown fences around the expected token. Resolve all paths against inv.workdir and emit the file body only.

Does verify-driver cost money for hosted agents?

Yes. Verifying a real hosted agent actually invokes it — two iterations plus file creation — which spends tokens and credentials. Develop the structure offline with unit tests or a local endpoint first, then run verify-driver once for real.

What does the applies-feedback scenario check?

It runs two iterations: iteration 0 writes a WRONG token, then iteration 1 supplies feedback.text and a prompt asking for a new token. Your driver must fold inv.feedback.text into the iteration-1 prompt so the file gets corrected.