Skip to content

[codex] Align skill creator paths with supported locations#31334

Open
alexsong-oai wants to merge 1 commit into
mainfrom
codex/skill-creator-supported-paths
Open

[codex] Align skill creator paths with supported locations#31334
alexsong-oai wants to merge 1 commit into
mainfrom
codex/skill-creator-supported-paths

Conversation

@alexsong-oai

@alexsong-oai alexsong-oai commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Document the supported skill save locations in the bundled skill-creator instructions.
  • Steer repository/project/workspace skills to .agents/skills, user skills to $HOME/.agents/skills, and admin skills to /etc/codex/skills.
  • Update init_skill.py help/examples to match the documented paths and make its sibling helper import stable when invoked by path.

Root Cause

The bundled skill-creator did not clearly map skill scope to the supported authoring paths. Its examples used generic skills/... paths, which could lead Codex to create valid SKILL.md files in locations that are not the documented repo/user authoring roots.

Fixes #14941.

Validation

  • python3 codex-rs/skills/src/assets/samples/skill-creator/scripts/quick_validate.py codex-rs/skills/src/assets/samples/skill-creator
  • python3 codex-rs/skills/src/assets/samples/skill-creator/scripts/init_skill.py --help
  • just fmt
  • just test -p codex-skills
  • git diff --check
  • Manual e2e smoke: ran current-branch just exec in a temporary git repo with $skill-creator; verified it created .agents/skills/e2e-skill-path-check/SKILL.md and the bundled quick_validate.py accepted the generated skill.

@alexsong-oai alexsong-oai requested a review from xl-openai July 7, 2026 01:21
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.

[BUG] Skill creator skill is confusing for the agent (skill placement)

1 participant