[FEATURE] Add option to configure skills path
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
Currently, Claude Code only discovers skills from fixed paths:
- ~/.claude/skills/ (personal)
- .claude/skills/ (project)
Some projects prefer to organize AI-related configuration files in a dedicated directory like .ai/ rather than .claude/. This keeps all AI tooling configuration (prompts, skills, guidelines) in one consistent location without dependency on a particular agent
Proposed Solution
Allow users to configure custom skill discovery paths via settings.json or .claude/settings.json:
{
"skills": {
"additionalPaths": [".ai/skills"]
}
}
Or at the project level in .claude/settings.json:
{
"skillPaths": [".ai/skills", "tools/claude-skills"]
}
Alternative Solutions
_No response_
Priority
Medium - Would be very helpful
Feature Category
Configuration and settings
Use Case Example
Consistent project structure — Projects using .ai/ for AI-related configs (guidelines, prompts) want skills in the same location (considering https://agentskills.io/specification)
Additional Context
Current Workaround
Using symlinks (ln -s ../.ai/skills .claude/skills) works but adds friction and can cause issues with some version control workflows
5 Comments
Found 3 possible duplicate issues:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
Related to #16345
Opencode has added a config for the skills location using a
skill.pathsconfig option:https://github.com/anomalyco/opencode/commit/db2739f
Also this issue is only related to #16345 and it is not a duplicate of it. Because #16345 is asking for support for a standard directory, while this issue is asking for a configuration option of the skill directory.
Closing for now — inactive for too long. Please open a new issue if this is still relevant.
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.