-
Notifications
You must be signed in to change notification settings - Fork 869
Proposal: include a standard folder where agent skills should be #15
Description
I highly appreciate that skills is becoming a standard that we can use across many different agent harnesses.
To make it even smoother, I believe that agreeing on a standard name for the agent skills folder would benefit everyone. This would allow different harnesses to have a default folder to find skills without requiring each project to put them in a different folder and create symlinks that match the specific folder of each harness.
Example: Claude is looking at .claude/skills/ and Github Copilot is looking at .github/skills/.
Edit: now we have Codex also looking at its own folder .codex/skills/
My suggestion for the name would be .agents/skills/, but I don't really care much about the name as long as it's agreed upon and standardized. It could even be just .skills/.
Adoption
Please help to keep the lists below up to date. 😄
Ready
- Amp: https://ampcode.com/manual#agent-skills
- Augment Code (Auggie): https://docs.augmentcode.com/cli/skills#skill-file-structure
- Goose: https://block.github.io/goose/docs/guides/context-engineering/using-skills/#skill-locations
- Codex: feat: Support loading skills from .agents/skills openai/codex#10317 and feat: Read personal skills from .agents/skills openai/codex#10437
- VS Code: Add support for .agents for skills resolution microsoft/vscode#292414
- VTCode: Deprecating and migrate .vtcode/skils to .agents/skills vinhnx/VTCode#600
- Pi: add support for reading skills from .agent/skills badlogic/pi-mono#1211 (configurable)
- Mistral Vibe: https://github.com/mistralai/mistral-vibe/blob/ec7f3b25eaf47c447f4005561ae2ff32545d3dff/CHANGELOG.md?plain=1#L14
- OpenCode: feat: add support for reading skills from .agents/skills directories anomalyco/opencode#11842
- OpenClaw: feat: support .agents/skills/ directory for cross-agent skill discovery openclaw/openclaw#9966
- Gemini CLI: feat(core): add .agents/skills directory alias for skill discovery google-gemini/gemini-cli#18151
- Craft Agents: Support .agents/skills convention lukilabs/craft-agents-oss#171
- RooCode: [ENHANCEMENT] Support .agents/skills folder RooCodeInc/Roo-Code#11368 (implemented and released but not documented yet)
- Cursor: https://x.com/leerob/status/2024141055143383184 (released)
- Windsurf: released on version 1.9552.21 (2026-02-12)
- Google Antigravity: https://antigravity.google/docs/skills
- Gwen Code: implemented on feat: add support for reading skills from
.agents/skillsQwenLM/qwen-code#2155
Pending
- Claude Code: [Feature Request] Support standard
.github/skills/directory for agent skills anthropics/claude-code#16345 - KiloCode: Support .agents/skills folder Kilo-Org/kilocode#5783
- Github: Proposal: include a standard folder where agent skills should be #15 (comment) (tracking work internally, will give an update when done)
Not adopting yet
There are too many tools to list here. Anyone not mention in "ready" or "pending" is considered not adopting yet.