Skip to content

Instructree v0.14.0

Choose a tag to compare

@kotobuki09 kotobuki09 released this 25 Aug 22:28

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-bom finding to instructree 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 codex

The 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 E005 from the exact attached tarball.
  • The package contains 21 files, has zero runtime dependencies, and includes a SHA-256 checksum.