Skip to content

docs: prove the Codex plugin claim and correct it to five namespaced skills#31

Draft
ohad6k wants to merge 1 commit into
mainfrom
agents/codex-claim-evidence
Draft

docs: prove the Codex plugin claim and correct it to five namespaced skills#31
ohad6k wants to merge 1 commit into
mainfrom
agents/codex-claim-evidence

Conversation

@ohad6k

@ohad6k ohad6k commented Jul 23, 2026

Copy link
Copy Markdown
Owner

What this is

The support-matrix row for the Codex native plugin said "Proven locally with four namespaced skills." The plugin carries five (mine, work, design, write, video). Bumping the number would have published a proof nobody re-ran since video landed, so I re-ran the install for real first.

Route taken: proved it. Codex is on this machine, and the install could be done entirely inside a sandboxed CODEX_HOME.

Exact commands

export CODEX_HOME='D:\emulo-codex-sandbox\home'   # sandbox, not ~/.codex
cd /d/emulo-codex-sandbox/work                    # neutral cwd, no repo-local skill discovery

codex --version
codex plugin marketplace add 'D:\ditto\.claude\worktrees\agent-a637852ca443f8ce5' --json
codex plugin add emulo@emulo --json
codex plugin list --json
codex debug prompt-input > prompt-input.json
grep -o 'emulo:[a-z]*' prompt-input.json | sort | uniq -c

Real output

### codex --version
codex-cli 0.144.4

### codex plugin marketplace add
{
  "marketplaceName": "emulo",
  "installedRoot": "D:\\ditto\\.claude\\worktrees\\agent-a637852ca443f8ce5",
  "alreadyAdded": false
}

### codex plugin add emulo@emulo
{
  "pluginId": "emulo@emulo",
  "name": "emulo",
  "marketplaceName": "emulo",
  "version": "0.6.0",
  "installedPath": "D:\\emulo-codex-sandbox\\home\\plugins\\cache\\emulo\\emulo\\0.6.0",
  "authPolicy": "ON_INSTALL"
}

### codex plugin list
{
  "installed": [
    {
      "pluginId": "emulo@emulo",
      "name": "emulo",
      "marketplaceName": "emulo",
      "version": "0.6.0",
      "installed": true,
      "enabled": true,
      "source": {"source": "local", "path": "D:\\ditto\\.claude\\worktrees\\agent-a637852ca443f8ce5"},
      "installPolicy": "AVAILABLE",
      "authPolicy": "ON_INSTALL"
    }
  ],
  "available": []
}

codex plugin list does not enumerate skills, so the load-bearing evidence is codex debug prompt-input — Codex rendering the skill list the model actually sees:

      1 emulo:design
      1 emulo:mine
      1 emulo:video
      1 emulo:work
      1 emulo:write

Each one resolves to the installed plugin cache, not to the checkout:

- emulo:design: Use for UI, UX, visual hierarchy, frontend-design judgment ...
  (file: D:/emulo-codex-sandbox/home/plugins/cache/emulo/emulo/0.6.0/skills/design/SKILL.md)
- emulo:mine:   Use only when the user explicitly asks to run, set up, update ...
  (file: D:/emulo-codex-sandbox/home/plugins/cache/emulo/emulo/0.6.0/skills/mine/SKILL.md)
- emulo:video:  Use for video direction, motion and pacing, shot and scene planning ...
  (file: D:/emulo-codex-sandbox/home/plugins/cache/emulo/emulo/0.6.0/skills/video/SKILL.md)
- emulo:work:   Use for execution, debugging, verification, planning, and shipping ...
  (file: D:/emulo-codex-sandbox/home/plugins/cache/emulo/emulo/0.6.0/skills/work/SKILL.md)
- emulo:write:  Use for marketing, social, replies, product copy, launch copy ...
  (file: D:/emulo-codex-sandbox/home/plugins/cache/emulo/emulo/0.6.0/skills/write/SKILL.md)

Five namespaced skills, live, from an installed plugin. The claim now matches what the host reports.

The change

-| Codex native plugin | Proven locally with four namespaced skills |
+| Codex native plugin | Proven locally with five namespaced skills (`emulo:mine`, `emulo:work`, `emulo:design`, `emulo:write`, `emulo:video`) |

One line in README.md. Nothing else staged.

No side effects on the real machine

  • Everything ran under CODEX_HOME=D:\emulo-codex-sandbox\home. ~/.codex was never the target.
  • ~/.codex/config.toml SHA-256 is 66944681a8077ec78e280512b99a97f100dbac306969be439e5cf5d146ccbc9a before and after.
  • Every entry under ~/.codex/plugins/ still carries its pre-run mtime (10:18 or earlier; the run was 16:16 to 16:20).
  • The sandbox directory was deleted after the evidence was captured.

Tests

python -m unittest tests.test_plugin_manifests tests.test_readme_cloud_boundary tests.test_proof_docs
Ran 27 tests in 0.026s
OK

Notes for the reviewer

  • Expect a conflict with docs: fix two stale README claims found by a full command audit #26 (agents/readme-audit). That branch also edits README.md, in different lines. I did not touch it. If docs: fix two stale README claims found by a full command audit #26 lands first, this row may need a trivial re-application.
  • Scope discipline: README line ~192 says the Claude Code plugin "exposes the same four skills." Stale in the same way, but it sits outside the row I was given and outside the Codex proof I ran, so I left it. Worth a separate pass.
  • --ref v0.6.0 is not yet fetchable. The documented remote install (codex plugin marketplace add ohad6k/emulo --ref v0.6.0) cannot run right now — there is no v0.6.0 tag on origin (latest is v0.5.0). That is why the proof used the local checkout, which is what "proven locally" claims anyway. Tagging is out of scope here, but the remote path stays unverifiable until the tag exists.

🤖 Generated with Claude Code

The support-matrix row said "Proven locally with four namespaced
skills" after `video` landed as a fifth. Rather than bump the number
on an unproven claim, re-ran the install for real.

Installed the local checkout as a Codex marketplace into a sandboxed
CODEX_HOME (codex-cli 0.144.4), then rendered the model-visible prompt
with `codex debug prompt-input`. It lists exactly five namespaced
skills: emulo:mine, emulo:work, emulo:design, emulo:write, emulo:video,
each resolving to the installed plugin cache. The real ~/.codex was
never written; sandbox deleted afterwards.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ditto Ready Ready Preview, Comment Jul 23, 2026 1:23pm

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant