Claude Code reads skills only from .claude folder, test finds
A test of 19 possible locations for skill files in Claude Code and Codex found only one location each read by the tools. Claude Code 2.1.290 detected skills only in the .claude/skills folder, while Codex 0.153.4 read from .agents/skills and .codex—though the latter is not officially documented. The author placed empty skill files in 19 folders, naming each probe-, and queried both tools to list…
Key points
- Claude Code 2.1.290 reads skills only from `.claude/skills` folder, Codex 0.153.4 reads from `.agents/skills` and `.codex`
- 16 of 19 tested locations yielded no results for either tool, including `.cursor` and `.gemini`
- Symbolic linking a skill file in `.agents/skills` to `.claude/skills` lets both tools access the same file
The experiment revealed a mismatch between documented and actual behavior: Codex read from .codex despite no mention in its documentation. To share skills across tools without duplication, the author linked a single file in .agents/skills to a symbolic link in .claude/skills. This approach ensures consistency when updating skills, as copying files to multiple locations risks inconsistencies. The author advises users to verify their skill locations with find .claude/skills .agents/skills -maxdepth 1 -mindepth 1 2>/dev/null and notes that home-directory locations (e.g., ~/.claude/skills) were not tested.
18 out of 19 locations: Where your skill files are not read by Claude Code
note.com · 5 October 2026
Loading the full article…
This text was published by note.com and written by カズ｜生成AI・エージェントラボ. It is reproduced here with attribution so you can read it in full; the rights remain with the publisher. Read it at the source ↗
The headline, key points and digest above were generated by Digest AI's editorial model from the linked sources. Automated summaries can contain errors: the sources are the record. Spotted a mistake? Tell us. Published by Martin K., who runs Digest AI and handles corrections.
More in Agents & Tools
All →- Claude, Cowork, and Claude Code differ in entry points and plan availability · 1 src
- Claude Code delegates posting measurements and PR to Digital Democracy 2030 · 1 src
- Cohere launches North 2 with redesigned agent harness and cross‑session memory · 2 src
- Anthropic’s Claude Sonnet 5.5 cuts coding tasks by 30% in speed and cost · 2 src
- Claude Code installs WordPress by measuring download speeds instead of waiting for timeout · 1 src
Comments
via GitHub Discussions