Files
skills/skills/productivity/README.md
T
697d4ce974 feat: add Codex agents/openai.yaml metadata to every skill
Adds an `agents/openai.yaml` beside each `SKILL.md` so the skills work in
Codex as well as Claude Code, without generated copies:

- `interface.display_name` + `interface.short_description` for the Codex
  skill picker, hand-written for all 39 skills.
- `policy.allow_implicit_invocation: false` on the 22 user-invoked skills —
  the Codex analog of `disable-model-invocation: true`, so Codex excludes
  them from implicit invocation while explicit `$skill` still works.
- Document the dual-harness invocation model in `.agents/invocation.md`,
  `CLAUDE.md`, and the promoted-bucket READMEs.
- Add `AGENTS.md` as a symlink to `CLAUDE.md` so Codex reads the same
  instructions; note Codex as a `link-skills.sh` install target.

Slimmed-down rework of the approach prototyped in #522: keeps the essential
cross-harness metadata, drops the Ruby validator, the runtime-detector test,
per-skill `default_prompt`s, and the unrelated promotion changes.

Co-authored-by: gabimoncha <gabimoncha@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-13 12:57:18 +01:00

1.1 KiB

Productivity

General workflow tools, not code-specific.

User-invoked

Reachable only when you type them (Claude Code: disable-model-invocation: true; Codex: policy.allow_implicit_invocation: false in agents/openai.yaml).

  • grill-me — Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved.
  • handoff — Compact the current conversation into a handoff document so another agent can continue the work.
  • teach — Teach the user a new skill or concept over multiple sessions, using the current directory as a stateful teaching workspace.
  • writing-great-skills — Reference for writing and editing skills well: the vocabulary and principles that make a skill predictable.

Model-invoked

Model- or user-reachable (rich trigger phrasing so the model can reach for them).

  • grilling — Interview the user relentlessly about a plan, decision, or idea until every branch of the decision tree is resolved.