Skip to content

fix(cli): include ~/.codex/skills in user skill discovery#487

Merged
hqhq1025 merged 1 commit intomainfrom
fix/codex-skills-discovery
Apr 17, 2026
Merged

fix(cli): include ~/.codex/skills in user skill discovery#487
hqhq1025 merged 1 commit intomainfrom
fix/codex-skills-discovery

Conversation

@hqhq1025
Copy link
Copy Markdown
Collaborator

Summary

  • Add ~/.codex/skills to getUserSkillsRoots() so Codex users' skills are discovered by the web UI $ autocomplete
  • Previously, only ~/.agents/skills and ~/.claude/skills were scanned; ~/.codex/skills was intentionally excluded as "legacy" but users actively store skills there
  • Hidden directories (.system/ etc.) inside skills roots are still skipped by the existing entry.name.startsWith('.') check
  • Priority order: .agents > .claude > .codex (first found wins for duplicate names)

Closes #482

Test plan

  • Updated test: ~/.codex/skills skills are now included in listing
  • Hidden subdirectories (.system/) are still excluded
  • Existing ~/.agents/skills and ~/.claude/skills behavior unchanged

The skill listing only scanned ~/.agents/skills and ~/.claude/skills
for user-level skills, ignoring ~/.codex/skills where Codex users
commonly store their skills. Add ~/.codex/skills to getUserSkillsRoots()
so these skills appear in the web UI $ autocomplete.

Hidden directories (starting with .) inside the skills root are still
skipped (e.g., .system/).

via [HAPI](https://hapi.run)

Co-Authored-By: HAPI <noreply@hapi.run>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying hapi with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4f53162
Status: ✅  Deploy successful!
Preview URL: https://c663ce59.hapi-bqd.pages.dev
Branch Preview URL: https://fix-codex-skills-discovery.hapi-bqd.pages.dev

View logs

Copy link
Copy Markdown

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review mode: initial

No diff-linked issues found in cli/src/modules/common/skills.ts:24 and cli/src/modules/common/skills.test.ts:72.

Residual risk: the updated test covers discovery from ~/.codex/skills and hidden-directory skipping, but it does not explicitly cover duplicate-name precedence between ~/.claude/skills and ~/.codex/skills; current behavior still depends on root order in cli/src/modules/common/skills.ts:26.

Testing: Not run (automation). bun is not installed in this runner, so bun test cli/src/modules/common/skills.test.ts could not be executed.

HAPI Bot

@hqhq1025 hqhq1025 merged commit b9d28f4 into main Apr 17, 2026
4 checks passed
@hqhq1025 hqhq1025 deleted the fix/codex-skills-discovery branch April 17, 2026 05:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant