Skip to content

Feat: add Codex Plannotator skills#644

Merged
backnotprop merged 1 commit intobacknotprop:mainfrom
leoreisdias:feat/codex-skills
May 2, 2026
Merged

Feat: add Codex Plannotator skills#644
backnotprop merged 1 commit intobacknotprop:mainfrom
leoreisdias:feat/codex-skills

Conversation

@leoreisdias
Copy link
Copy Markdown
Contributor

@leoreisdias leoreisdias commented May 1, 2026

Summary

  • add Codex-callable Plannotator skills for review, annotate, and last
  • document the Codex skill entrypoints in the README
  • keep plan mode out of scope; this only improves the existing manual Codex flows

Why

Codex app does not accept ! commands in chat, so the current direct shell-style Plannotator invocations are awkward or unavailable in the app experience.

There is also a workflow gap when Plannotator returns annotations in Codex CLI: the agent receives the feedback, but it does not proactively act on it unless the user sends another explicit follow-up message.

These skills help in both places:

  • they make Plannotator callable from Codex app through $plannotator-* skills
  • they instruct the agent to run the command itself, wait for the browser session to finish, and then act on the returned feedback without requiring an extra user prompt

Screenshots

Codex App - Skill execution and waiting responses:
image

Codex App - Receiving annotation and acting on it:
image

Scope notes

This PR focuses only on the user-invoked Codex flows that already map well to Plannotator today.

Test plan

  • verify the new skill folders are present under apps/skills/
  • verify the README documents the Codex skill entrypoints

@leoreisdias leoreisdias changed the title Add Codex Plannotator skills Feat: add Codex Plannotator skills May 1, 2026
@backnotprop
Copy link
Copy Markdown
Owner

@leoreisdias thanks!!

@backnotprop
Copy link
Copy Markdown
Owner

How will these get installed. Maybe we should ship a plugin

@leoreisdias
Copy link
Copy Markdown
Contributor Author

How will these get installed. Maybe we should ship a plugin

thanks for the follow up @backnotprop !

about the installation, the existing installer already copies apps/skills/* into ~/.agents/skills (install.sh / install.ps1 / install.cmd), and codex can pick skills up from there, so a plugin wouldnt be needed as these should install from the normal Plannotator script once they re in a release

but I like the idea for speed and discoverability. I am going to take a look at how this is usually set up and whats needed. Should we do it within this PR or a separated one? thoughts? 🙂

@backnotprop
Copy link
Copy Markdown
Owner

Merging, have a cool stop hook for plan mode coming in as well #577

@backnotprop backnotprop merged commit a95db50 into backnotprop:main May 2, 2026
7 checks passed
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.

2 participants