Skip to main content
Use the skill’s report and the Wizard’s status to find the step that needs attention.

​
Find a missing skill

For a Wizard-managed installation, inspect the cached bundle and client installation:
skill list lists the skills in the Wizard’s bundle and may prompt to download a release. In status, check the selected client’s plugin.state and plugin.verified fields. If the plugin is missing, follow Install the Straddle plugin. For a mismatched Wizard-managed copy, update it and restart the client:
Use --client codex for Codex. In Cursor, refresh the team marketplace and check the installed skill names in the IDE. The Wizard’s status cannot verify Cursor team-marketplace installations.

​
Resolve a marketplace conflict

The Wizard stops if a marketplace named straddle points to a different directory from its verified plugin bundle. Choose whether to keep that installation or let the Wizard manage it. To switch to the Wizard, remove the existing Straddle plugin and marketplace through your client, then run the installation steps. Keep your other marketplaces in place.

​
Resolve a configuration finding

Setup distinguishes missing configuration from checks that failed. Correct the named setting, then run Setup again:
For API MCP, supply STRADDLE_API_KEY to the coding client’s process separately from the Straddle CLI’s saved credentials. Check MCP authentication and select the sandbox environment explicitly. If discovery succeeds but an authenticated request fails, use MCP troubleshooting.

​
Unblock Integrate or Test

Integrate needs an approved straddle-integration-plan.md. Test accepts an approved integration or migration plan and needs the corresponding code. Run Plan when the integration plan is missing. If the plan changed after approval, review the revised file and approve it again before continuing. Keep the approval attached to the current plan.

​
Interpret incomplete test evidence

Read the individual rows in straddle-test-evidence.md. A scenario can be blocked by missing configuration, waiting for approval, or require a person to complete a browser flow. The report names what ran and what still needs evidence. Correct the specific cause, then rerun Test. If a check found an implementation defect, return to Integrate before testing again.

​
Audit an existing failure

Ask your agent to investigate with Audit:

Investigate a Straddle integration failure.

Audit checks each finding against the installed SDK and API contract. Review its proposed fix before authorizing code changes.