Skip to content

audit: invented .codex paths and dropped frontmatter #12

Closed

Description

@caelaxie

weekly audit vs pstack 0.15.32 (cursor/plugins 99b609a), port main ac69d13.

files: .agents/skills/poteto-mode/playbooks/worktree-cleanup.md, .agents/skills/reflect/references/judgment-reviewer.md, divergent-reviewer.md, tooling-reviewer.md, .agents/skills/poteto-mode/SKILL.md frontmatter.

worktree-cleanup.md upstream names a worktree cursor actually uses:

a hand-typed myrepo-worktrees/x misses one that lives at .cursor/worktrees/myrepo/x

the port says .codex/worktrees/myrepo/x. nothing in this repo or the adapter defines that path.

the three reflect reviewer prompts change ~/.cursor/plugins/ to ~/.codex/plugins/. upstream:

a Read of its SKILL.md (under .cursor/skills/, ~/.cursor/skills/, or ~/.cursor/plugins/)

poteto-mode SKILL.md drops frontmatter that is not cursor-only metadata the adapter accounts for:

icon: crown
color: yellow

smallest fix: do not restore the cursor paths (.cursor/worktrees/..., ~/.cursor/plugins/); ports must not keep cursor-specific paths. instead replace the invented .codex/worktrees and ~/.codex/plugins with the path codex actually uses, citing codex docs if the fix pr can find it; otherwise use neutral phrasing such as "the directory git worktree list shows". restore the two icon / color frontmatter lines.

fix with Closes #N.

Activity

  1. caelaxie commented on Oct 26, 2026

    @caelaxie
    ContributorAuthor

    path half is in #21 (Refs #12).

    not restoring icon / color on poteto-mode SKILL.md. codex 0.164.0 (codex-rs/core-skills/src/loader.rs, SkillFrontmatter) reads name, description, and metadata only. ui icons and brand color are agents/openai.yaml fields (icon_small, icon_large, brand_color). the bundled skill-creator validator allows name, description, license, allowed-tools, and metadata, and rejects other keys.

    worktrees are not one directory. the app default reported in openai/codex#10599 is ~/.codex/worktrees/<id>/<repo>, and codex --worktree (openai/codex#21435) uses a sibling checkout. the playbook now says the directory git worktree list shows.

    plugin skills are ${CODEX_HOME:-~/.codex}/plugins/cache/<marketplace>/<plugin>/<version>/ (PLUGINS_CACHE_DIR in codex-rs/core-plugins/src/store.rs). default CODEX_HOME is ~/.codex. ~/.codex/plugins/ is not that directory.

    if you still want the two frontmatter lines put back even though the loader ignores them, say so.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions