Platform Install Paths

Codex and Claude Code use the same skill directory shape, but their default paths and direct invocation syntax differ.

Agent Surface Differences

Surface	User-wide path	Project path	Invocation
Codex	`~/.agents/skills/<skill-name>`	`.agents/skills/<skill-name>`	`$skill-name ...`
Claude Code	`~/.claude/skills/<skill-name>`	`.claude/skills/<skill-name>`	`/skill-name ...`

PowerShell expands $HOME to the user's profile directory.

$HOME\.agents\skills\github-skill-curator
$HOME\.claude\skills\github-skill-curator

Shells expand ~ to the user's home directory.

~/.agents/skills/github-skill-curator
~/.claude/skills/github-skill-curator

Project-level installs are useful when a skill should travel with a repository or stay scoped to one workspace.

.agents/skills/github-skill-curator
.claude/skills/github-skill-curator

Prefer project-level install for experimental or repository-specific skills. Prefer user-wide install for stable skills used across many projects.

Codex 和 Claude Code 使用相似的 skill 目录结构，但默认路径和调用语法不同。

使用环境	用户级路径	项目级路径	调用方式
Codex	`~/.agents/skills/<skill-name>`	`.agents/skills/<skill-name>`	`$skill-name ...`
Claude Code	`~/.claude/skills/<skill-name>`	`.claude/skills/<skill-name>`	`/skill-name ...`

Windows PowerShell 中，$HOME 会展开到用户目录：

$HOME\.agents\skills\github-skill-curator
$HOME\.claude\skills\github-skill-curator

macOS / Linux 中，~ 会展开到用户 home：

~/.agents/skills/github-skill-curator
~/.claude/skills/github-skill-curator

实验性或项目专用 skill 更适合项目级安装；稳定且经常使用的 skill 更适合用户级安装。