Skip to content

fix: update default system skill paths to .agents/skills#482

Open
DakshUbhadia wants to merge 1 commit into
openai:mainfrom
DakshUbhadia:fix/issue-420-skill-paths
Open

fix: update default system skill paths to .agents/skills#482
DakshUbhadia wants to merge 1 commit into
openai:mainfrom
DakshUbhadia:fix/issue-420-skill-paths

Conversation

@DakshUbhadia

Copy link
Copy Markdown

Summary

This PR addresses the directory canonization mismatch reported in issue #420. The current public guidelines point users toward the newer ~/.agents/skills convention, but the default fallback behavior inside skill-installer and skill-creator still implemented and documented the legacy ~/.codex/skills directory.

Changes Made

  • Updated _default_skills_dir() and _default_dest() fallback methods across init_skill.py, install-skill-from-github.py, and list-skills.py to point to ~/.agents/skills when $CODEX_HOME is unset.
  • Preserved backward compatibility by maintaining structural evaluation of explicit $CODEX_HOME parameters.
  • Updated argparse documentation/help descriptions to display the new pathing standards.
  • Patched SKILL.md files to align execution behavior with the user-facing instruction sets.

Testing / Validation

  • Successfully ran internal verification routines (quick_validate.py) across modified skill domains to ensure metadata schema schema validity (Skill is valid!).
  • Verified execution pathways locally to confirm newly targeted directories load properly under Windows system structures.

Fixes #420

Migrates default resolution paths and documentation from legacy ~/.codex/skills to the newer ~/.agents/skills convention. Fixes openai#420.
@DakshUbhadia DakshUbhadia requested a review from a team June 8, 2026 13:14
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.

skill-installer and skill-creator still default to ~/.codex/skills while current docs point users toward ~/.agents/skills

2 participants