Skip to content

docs: fix two stale README claims found by a full command audit#26

Draft
ohad6k wants to merge 1 commit into
mainfrom
agents/readme-audit
Draft

docs: fix two stale README claims found by a full command audit#26
ohad6k wants to merge 1 commit into
mainfrom
agents/readme-audit

Conversation

@ohad6k

@ohad6k ohad6k commented Jul 23, 2026

Copy link
Copy Markdown
Owner

Two corrections found by auditing every command in the README against the code.

  • The Claude Code plugin exposes five skills (mine, work, design, write, video), not four. Line 178 already listed five.
  • The MCP tool description omitted video. Confirmed by calling tools/list over stdio: the domain enum is ["design","video","work","write"].

32 commands checked, 24 executed--dry-run, mcp over stdio, plugin preflight with and without --preview, --card, and all six --install --target adapters (codex, claude, cursor, agents, gemini, opencode).

Reported, not changed

  • Line 314 says the Codex plugin is "proven locally with four namespaced skills". The count is stale the same way, but "proven locally" is a proof claim and no live Codex install has been re-run since video landed. Changing it would publish a proof nobody ran.
  • The v0.6.0 tag does not exist on origin (latest is v0.5.0), so --ref v0.6.0 and the raw.githubusercontent.com/.../v0.6.0/emulo.py URL both fail today. Both are pinned to EMULO_VERSION by tests, so the suite passes while the public install path is broken.

Tests touching the README pass: 27 tests, OK.

Written by an agent working in an isolated worktree, reviewed before push.

Audited every command in README.md against the source.

- The Claude Code plugin section said "the same four skills". The plugin
  discovers five (mine, work, design, write, video), which the section
  three lines above already lists and tests/test_plugin_manifests.py
  asserts. Corrected to five.
- The MCP section said load_emulo_profile returns a work, design, or
  writing profile. A live `python emulo.py mcp` tools/list shows the
  domain enum is design, video, work, write. Added video.

Everything else in the README was verified and left untouched:
--dry-run, --chunks/--out, --card, all six --install --target adapters,
plugin preflight (with and without --preview), --stage {A,B}, the plan
JSON keys, `emulo mcp` via the pyproject console script, and the codex
plugin marketplace add/add flags against codex-cli 0.144.4.

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:07pm

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