Skip to content

feat: make the researcher an internal tool finder - #5

Merged
igorjs merged 3 commits into
mainfrom
feat/restructure-skills-for-codex-s5-researcher-as-internal-tool-finder
Nov 14, 2026
Merged

igorjs merged 3 commits into
mainfrom
feat/restructure-skills-for-codex-s5-researcher-as-internal-tool-finder

Conversation

@igorjs

@igorjs igorjs commented Nov 13, 2026

Copy link
Copy Markdown
Member

Summary

The researcher sets user-invocable: false, lists the tools and MCP servers it can use on every run, and can read an optional docs/playbook/context.yaml that ranks sources per request type. Check 6 guards the frontmatter key.

Notes for reviewers

The smoke test passes for both hosts with the new key: sh scripts/smoke-install.sh; echo "exit=$?" printed exit=0. That proves Codex installs the plugin, not that it loads the skill with the unknown key. The two manual checks are still open. I will record your answers here: (1) Codex lists and loads all three skills, (2) /playbook:researcher does not appear in the Claude Code / menu.

@igorjs
igorjs force-pushed the feat/restructure-skills-for-codex-s4-planner-and-implementer-contract branch from 02e7bf4 to dbdbe00 Compare November 14, 2026 01:40
@igorjs
igorjs force-pushed the feat/restructure-skills-for-codex-s5-researcher-as-internal-tool-finder branch from 5b5182d to c7b1126 Compare November 14, 2026 01:40
@igorjs
igorjs force-pushed the feat/restructure-skills-for-codex-s4-planner-and-implementer-contract branch from dbdbe00 to 133265e Compare November 14, 2026 01:40
@igorjs
igorjs force-pushed the feat/restructure-skills-for-codex-s5-researcher-as-internal-tool-finder branch 2 times, most recently from b93160f to a5c3a3e Compare November 14, 2026 01:42
@igorjs
igorjs force-pushed the feat/restructure-skills-for-codex-s4-planner-and-implementer-contract branch from 133265e to be250c0 Compare November 14, 2026 01:42
Hide the researcher from the Claude Code menu with user-invocable: false,
make it list available tools and MCP servers on every run, and document
the optional docs/playbook/context.yaml hints file. Check 6 guards the
frontmatter key.

Signed-off-by: igorjs <2278164+igorjs@users.noreply.github.com>
- Replace the last em dash, in the architecture finding example.
- Ask for approval before the planner hands a plan over, and respect a user-named document root.
- Say the researcher can still be called in Codex, and read context.yaml from the document root.

Signed-off-by: igorjs <2278164+igorjs@users.noreply.github.com>
- check.sh compares the Codex marketplace name with the Claude Code one. Case 87 covers it.
- test-check.sh marks a nested run with its copy root, so an inherited TEST_CHECK_NESTED or TEST_CHECK_CLI_DIRS has no effect.

Signed-off-by: igorjs <2278164+igorjs@users.noreply.github.com>
@igorjs
igorjs force-pushed the feat/restructure-skills-for-codex-s5-researcher-as-internal-tool-finder branch from a5c3a3e to d4b8e51 Compare November 14, 2026 01:44
@igorjs
igorjs changed the base branch from feat/restructure-skills-for-codex-s4-planner-and-implementer-contract to main November 14, 2026 01:44
@igorjs
igorjs marked this pull request as ready for review November 14, 2026 01:45
@igorjs
igorjs merged commit 4fe0eb8 into main Nov 14, 2026
1 check passed
@igorjs

igorjs commented Nov 14, 2026

Copy link
Copy Markdown
Member Author

Both manual checks are done. Codex 0.163.0 loads playbook:planner, playbook:implementer and playbook:researcher from the installed plugin, as codex debug prompt-input shows, and reports no error for user-invocable. Claude Code installed the researcher with user-invocable: false, and the Claude Code skills docs say that flag hides a skill from the / menu. I did not open the menu to look.

@igorjs
igorjs deleted the feat/restructure-skills-for-codex-s5-researcher-as-internal-tool-finder branch November 14, 2026 03:01
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