Shared prompt and skill assets for agentic workflows.
<directory>/
prompts/: general, portable, provider-agnostic prompt file/sskills/<skill>/SKILL.md: skill files for providers to consumeconfigs/: provider-specific config files and/or instructions
Every provider has different conventions.
Docs: developers.openai.com/codex/skills
Location: .agents/skills/<skill>/SKILL.md
.agents/ can be provided in the home dir or project level.
Docs: code.claude.com/docs/en/skills
Location: .claude/skills/<skill>/SKILL.md
.claude/ can be provided in the home dir or project level.
Use symlinks when you want one shared skill source instead of copying files into each provider directory.
# Codex
mkdir -p "<location>/.agents/skills"
ln -s "$HOME/.local/share/ai-lib/<path-to-skill>" "<location>/.agents/skills/<skill>"
# Claude
mkdir -p "<location>/.claude/skills"
ln -s "$HOME/.local/share/ai-lib/<path-to-skill>" "<location>/.claude/skills/<skill>"