ABOUTCODEX / TROUBLESHOOTING

Find help by the symptom

Start with what went wrong. Follow a focused check and a connected guide.

START WITH THE SYMPTOM

Skill does not appear

Check the extracted folder, exact SKILL.md filename, and frontmatter. Compare your setup with the installation guide.

START WITH THE SYMPTOM

Compare the request with the skill description. Use a narrow explicit request and check which procedure was selected.

START WITH THE SYMPTOM

Confirm the working folder and the exact file path. Ask for a read-only inventory before changing files.

START WITH THE SYMPTOM

Restate the outcome, allowed files, and acceptance criteria. Review the proposed change before proceeding.

START WITH THE SYMPTOM

Record the last completed step, failing command, and missing information. Reduce the problem to one observable check.

START WITH THE SYMPTOM

Locate the applicable project instructions and identify the precise conflict. Avoid adding another broad rule.

START WITH THE SYMPTOM

Inspect the page at a narrow width and identify whether the block, theme, or custom CSS owns the failing dimensions.

START WITH THE SYMPTOM

Reproduce the sequence with a small fixture. Add a regression check for repeated calls and verify the same test before and after.