Regression: pup-adom-wiki SKILL.md has invalid YAML again in 2.0.451; Codex skips the skill

by adom

pup gives your AI a real browser on your desktop that it drives completely, in the background, signed in as you: windows that never jump in front of your work, one shared profile that learns your logins, and every window labeled on the taskbar with its AI thread's name.

Overview Files Skills Discover Packages Releases Dependencies Issues17 Breadcrumbs Pull Requests1 Activity

Closed bug report

John Lauer · 2mo ago ·closed by John Lauer

Environment: adom/pup-bridge skills package 2.0.451; live Pup 2.0.451 (Rust); Adom Bridge 2.1.82 on Windows; Codex CLI 0.153.0 in Linux/WSL2; adom/codex 0.1.22. Reproduced 2026-09-09.

Codex cannot load pup-adom-wiki because its YAML description is double-quoted but contains unescaped double quotes in wikiView:"public".

Reproduction:

Use the installed adom/pup-bridge 2.0.451 skills.
Start Codex, or strictly parse the YAML frontmatter in skills/pup-adom-wiki/SKILL.md.
The skill is rejected instead of being discovered.

Current verification: the installed package copy and ~/.codex/skills/pup-adom-wiki/SKILL.md both fail PyYAML safe_load. Exact parser output:

while parsing a block mapping
  in "<unicode string>", line 2, column 1:
    name: pup-adom-wiki
    ^
expected <block end>, but found '<scalar>'
  in "<unicode string>", line 4, column 720:
     ... logged in everywhere; wikiView:"public" is the explicit logged-O ...
                                         ^

Earlier Codex error: invalid YAML: did not find expected key.

Regression context: this same description was previously converted to a folded block scalar and verified in package 2.0.431 on 2026-09-06. The installed 2.0.451 copy has returned to the malformed double-quoted form. Please preserve the correction across concurrent releases.

Requested fix:

Use description: >- with the full existing description indented beneath it.
Strictly parse every bundled SKILL.md YAML header before publishing; permissive package lint previously only warned.
Publish/install the corrected skills and verify both the package and mirrored Codex copy.
Verify automatic discovery in a fresh Codex chat. Existing chats may need to explicitly read the corrected skill file to get its instructions.

No duplicate found among the 102 existing issues. This report is about skill metadata, not a failure of the running browser bridge.

1 Reply

John Lauer · 2mo ago

Fixed in 2.0.452 (insiders, installed on the boxes). Thank you for the exact parser output.

Why it regressed. The 2.0.431 correction was made in the wiki repo copy of skills/pup-adom-wiki/SKILL.md and never in the release working tree, so the next source push overwrote it. A strict parse of the tree found two more (dev-only, never shipped in the package): pup-differential-diagnosis and pup-hero-image, both plain-scalar descriptions containing ": ".

What changed.

All three descriptions are now description: >- folded block scalars, the full text indented beneath.
tools/ship.sh gained step 2b: a strict PyYAML safe_load of every skills/, dev-skills/, publish-skills/ and root SKILL.md frontmatter, requiring name and description strings, run BEFORE the skills package is published; the ship aborts on the first invalid file (2.0.452 run: 37 files parsed, 0 invalid). The package lint's warning is no longer the only guard.

Verified. adom-wiki pkg install adom/[email protected] on this container: every installed pup skill copy under ~/.claude/skills parses strictly, and the mirrored ~/.codex/skills/pup-adom-wiki/SKILL.md parses too (both written 13:59 today). The skill is discovered in a fresh session here. Existing Codex chats may need to read the corrected file once, as you noted.

John Lauer closed this · 2mo ago