[FEATURE] Custom skills directory paths via env var or settings

[JayDoubleu]

Preflight Checklist

• I have searched existing requests and this feature hasn't been requested yet
• This is a single feature request (not multiple features)

Problem Statement

Skills can only be loaded from hardcoded paths:

• ~/.claude/skills/
• <project>/.claude/skills/
• Plugin-relative paths

No way to point Claude at a custom directory like .agents/skills/ without symlinks or complex plugin setups.

Use Cases

• Project uses .agents/skills/ or scripts/claude/skills/ for organization
• Don't want to restructure repo or maintain symlinks
• Want team to share skills from a custom location

Potential Solutions

Option A: Environment variable

CLAUDE_SKILLS_PATH=".agents/skills"

Option B: Settings.json

{
  "additionalSkillsPaths": [".agents/skills"]
}

Option C: Support ${CLAUDE_PROJECT_DIR} in plugin.json skills paths
Currently only ${CLAUDE_PLUGIN_ROOT} works.

Priority

Medium - Quality of life

---

This issue was created using Claude Code 🤖

[github-actions]

Found 3 possible duplicate issues:

1. [FEATURE] Add option to configure skills path #18621
2. [Feature Request] Support standard .github/skills/ directory for agent skills #16345
3. [FEATURE] Claude Code requires some built-in environment variables to facilitate the development of custom plugins. #12541

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

[JayDoubleu]

Closing as duplicate of #18621 which requests the same feature. Upvoted that one instead.

[github-actions]

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.