Documentation · Troubleshooting

Understand what failed, why it matters, and what to do next.

The workflow is intentionally conservative when source quality or authority is unclear.

The host cannot find the skill

Confirm that the complete control-agency-scope-changes folder—not only SKILL.md—is in the supported skills directory, then start a new session.

The result says Unable to determine

Confirm that a readable baseline exists, identify it explicitly, and include any essential referenced attachment.

The result is unexpectedly low confidence

Check for vague language, mixed requests, unclear limits, missing status, contradictory documents, or undefined technical assumptions.

A client draft was withheld

This is expected below the configured confidence threshold or when a stop condition applies. Resolve the listed missing information and rerun the review.

PDF or DOCX text is incomplete

Use a better source copy or your host's supported extraction path. The skill does not bundle a PDF or DOCX extraction engine.

Optional validation fails

Confirm Python 3 and PyYAML are installed, use the supplied configuration, and fix the exact field named by the validator.