Instructree v0.14.0
Catch Windows skill-loading failures before Codex does
instructree scan . now reports E005 when a SKILL.md starts with a UTF-8 byte-order mark (BOM). Current Codex builds can reject that otherwise valid frontmatter and misleadingly report that YAML frontmatter is missing, as documented in openai/codex#13918.
- Parses the valid metadata behind the BOM, avoiding cascaded missing-field errors.
- Adds the same actionable
unsupported-utf8-bomfinding toinstructree skills. - Emits the new rule in JSON and SARIF for local checks and GitHub code scanning.
- Does not warn for a BOM character in the skill body or for non-skill frontmatter.
npx --yes github:kotobuki09/instructree#v0.14.0 scan .
npx --yes github:kotobuki09/instructree#v0.14.0 skills . --client codexThe implementation is grounded in the current Codex parser behavior.
Verification
- Arbor development and fresh held-out evaluators: 100/100 each.
- 59 local tests: 57 passed, 2 expected Windows symlink skips, 0 failures.
- All nine OS/Node CI jobs, code scanning, and GitHub Pages passed on the release commit.
- The packed-install smoke test reproduced
E005from the exact attached tarball. - The package contains 21 files, has zero runtime dependencies, and includes a SHA-256 checksum.