Skip to content

Platform Install Paths

Connor edited this page Jul 3, 2026 · 2 revisions

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 ...

Windows Paths

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

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

macOS and Linux Paths

Shells expand ~ to the user's home directory.

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

Project-Level Installs

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.

Clone this wiki locally