encoding-fix-script-first

Enforce script-only text encoding fixes in any repository. Use when files contain mojibake, broken Cyrillic/UTF-8 text, or UTF-8 BOM issues, and require Codex to run the bundled `scripts/fix_mojibake.

SKILL.md

GitHub

Encoding Fix Policy

Use this skill only for encoding/BOM correction tasks. Do not use this skill for layout, SEO, routing, or feature implementation.

Workflow

  1. Identify target files or directories with suspected encoding issues.
  2. Run only the bundled script for fixes:
    • python scripts/fix_mojibake.py <paths...>
    • On Windows fallback: py -3 scripts/fix_mojibake.py <paths...>
    • Script behavior: if ftfy is missing, it installs ftfy automatically and continues.
  3. If preview mode is needed first, run:
    • python scripts/fix_mojibake.py --dry-run <paths...>
  4. Limit extensions when needed:
    • python scripts/fix_mojibake.py <paths...> --extensions .php .html .js .css .md .xml .yaml
  5. Re-run the script after edits if new mojibake appears.

Output Format

In the final response:

  • List processed paths.
  • Include the exact fix_mojibake.py command used.
  • Report whether files changed.

Hard Rules

  • Do not manually rewrite mojibake text as a primary fix.
  • Do not use ad-hoc recoding via editors/scripts when scripts/fix_mojibake.py can handle the case.
  • If script output is insufficient, report remaining files and ask for explicit permission before custom recovery steps.