fix

Diagnose and fix defects using Veris twins to test changed application behavior.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/veris-ai/plugins --skill fix-veris-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fix
Source: https://github.com/veris-ai/plugins/tree/main/veris/skills/fix
Command: npx skills add https://github.com/veris-ai/plugins --skill fix-veris-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires veris.

What problem does it solve? Fixing defects that involve external service calls is hard to verify because real vendor APIs cannot be safely exercised in tests. This Skill investigates a reported defect, implements the fix, and tests the changed application against a Veris twin that simulates the external services, producing receipt-based evidence that the fix works. ## Core Features & Use Cases - Defect Investigation: Reads the issue (via gh issue view) or prompt, inspects affected code, and reproduces failures through the application or twin fault injection. - Twin-Backed Verification: Runs the repository's existing integration tests against the sandbox twin, asserting responses and confirming traffic via receipts and traces. - Evidence and Handoff: Summarizes changes with cited evidence, updates .veris/NOTES.md findings, and follows the repository's PR conventions. - Use Case: Given an issue like "create_invoice duplicates the invoice when the response is lost", reproduce the retry behavior against the twin, fix the idempotency handling, and verify the affected caller passes with current-run twin evidence. ## Quick Start Ask the assistant to fix a defect by providing an issue link or prompt, for example: run the fix command for https://github.com/org/repo/issues/42 and verify the changed behavior against the Veris twin.

Frequently Asked Questions about fix

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

FAQPage Schema
How do I fix a bug that involves external API calls?▼

Provide an issue link or prompt describing the defect. The Skill reads the issue, inspects the affected code, reproduces the failure through the application or twin fault injection, implements the fix, and runs the affected test against the Veris twin.

How do I verify a fix without calling real vendor APIs?▼

Run the repository's existing integration test through the Veris sandbox, which reroutes outbound HTTP(S) to a twin of the vendor service. The test asserts the expected outcome and the run's receipt shows the application traffic reached the twin.

Does the fix command require the Veris CLI and Docker?▼

CLI-owned workflows need the veris CLI signed in and the repository wired by setup. Plugin-managed sessions use the OpenCode plugin's remote tools instead, so local CLI installation and Docker are not prerequisites for that path.

When should I rerun setup before fixing a defect?▼

Rerun setup only when a handoff step is missing, the connection is broken, or the change invalidates its wiring, such as adding a vendor service or hostname. An application assertion failure alone is not a reason to redo setup.

What if my change has no external service interaction?▼

For changes with no meaningful vendor interaction, skip Veris setup and twin work entirely. Use the repository's own validation and state that scope in the result.