[FEATURE] Add option to configure skills path

Status Closed — not planned
Maintainer reply None cached
Activity 5 comments · opened Jan 16, 2026 · closed Mar 1, 2026

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

View original on GitHub ↗

5 Comments

github-actions[bot] · 9 months ago

Found 3 possible duplicate issues:

  1. https://github.com/anthropics/claude-code/issues/16345
  2. https://github.com/anthropics/claude-code/issues/15099
  3. https://github.com/anthropics/claude-code/issues/5659

This issue will be automatically closed as a duplicate in 3 days.

  • If your issue is a duplicate, please close it and 👍 the existing issue instead
  • To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

dimonchik0036 · 9 months ago

Related to #16345

samal-rasmussen · 8 months ago

Opencode has added a config for the skills location using a skill.paths config 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.

github-actions[bot] · 7 months ago

Closing for now — inactive for too long. Please open a new issue if this is still relevant.

github-actions[bot] · 7 months ago

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.