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.