skill-creator: default new skills to ~/.codex/skills

[xl-openai]

Motivation

• Prevent newly-created skills from being placed in unexpected locations by prompting for an install path and defaulting to a discoverable location so skills are usable immediately.
• Make the skill-creator instructions explicit about the recommended default (~/.codex/skills / $CODEX_HOME/skills) so the agent and users follow a consistent, discoverable convention.

Description

• Updated codex-rs/skills/src/assets/samples/skill-creator/SKILL.md to add a user prompt: "Where should I create this skill? If you do not have a preference, I will place it in ~/.codex/skills so Codex can discover it automatically.".
• Added guidance before running init_skill.py that if the user does not specify a location, the agent should default to ~/.codex/skills (equivalently $CODEX_HOME/skills) for auto-discovery.
• Updated the init_skill.py examples in the same SKILL.md to use ~/.codex/skills as the recommended default while keeping one custom path example.

Testing

• Ran cargo test -p codex-skills and the crate's unit test suite passed (1 passed; 0 failed).
• Verified relevant discovery behavior in code by checking codex-rs/utils/home-dir/src/lib.rs (find_codex_home defaults to ~/.codex) and codex-rs/core/src/skills/loader.rs (user skill roots include $CODEX_HOME/skills).

---

Codex Task

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3ec95126df

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Resolve default skill path from CODEX_HOME

Do not treat ~/.codex/skills as equivalent to $CODEX_HOME/skills. If a user sets CODEX_HOME to a custom directory, this instruction creates skills in a different location that may not be auto-discovered. The default guidance should derive from CODEX_HOME (or explicitly fall back to ~/.codex) instead of hardcoding ~/.codex/skills.

Useful? React with 👍 / 👎.

[xl-openai]

@codex fix this.

[chatgpt-codex-connector]

Summary

• Updated the skill-creator prompt and setup guidance so the default install path is derived from $CODEX_HOME/skills, with ~/.codex/skills only as the fallback when CODEX_HOME is unset. codex-rs/skills/src/assets/samples/skill-creator/SKILL.mdL256-L292
• Updated the init_skill.py examples to use --path "${CODEX_HOME:-$HOME/.codex}/skills" so the examples match the same precedence/fallback behavior. codex-rs/skills/src/assets/samples/skill-creator/SKILL.mdL305-L307
• Committed the change (187a415) and created a follow-up PR with title “Follow-up: resolve skill-creator default path via CODEX_HOME”.

Testing

• ✅ cargo test -p codex-skills
• ⚠️ python - <<'PY' ... urllib.request.urlopen('https://duckduckgo.com/html/?q=...') ... PY (web search attempt failed in this environment with 403 Forbidden)
• ⚠️ curl -fsSL 'https://r.jina.ai/http://duckduckgo.com/?q=bash+parameter+expansion+default+value+unset' | head -n 40 (web search proxy returned 403)

View task →