Update $skill-creator guidance to cover named-arg migration from custom prompts BEFORE custom prompts deprecation

Resolved 💬 1 comment Opened Mar 20, 2026 by santiago-afonso Closed Mar 29, 2026

What variant of Codex are you using?

cli

What feature would you like to see?

$skill-creator should explicitly document the current migration story for deprecated custom prompts that used named args.

Right now, the guidance mentions default_prompt, but it does not clearly explain that:

  • skills do not currently have first-class named arguments like custom prompts did
  • interface.default_prompt can be used as a practical workaround to prefill a named-args-looking invocation

(Note that this is only a UX suggestion / text insertion pattern.)

Suggested update:
add a short section to the skill-creation guidance explaining how to migrate slash-command named args to skills, including a recommended pattern like:

interface:
default_prompt: "Use $my-skill FILE= MODE="

This would make the migration guidance much clearer for users converting deprecated custom prompts into skills.

Relevant files:

  • config/wsl-linux/.codex/skills/.system/skill-creator/SKILL.md
  • config/wsl-linux/.codex/skills/.system/skill-creator/references/openai_yaml.md

Additional information

_No response_

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗