Skills not loading from .claude/skills/ directory

[gorbach]

Description

Skills defined in .claude/skills/ directory are not appearing in the Skill tool's available skills list.

Environment

• Platform: Linux (NixOS)
• OS Version: Linux 6.12.63
• Model: claude-sonnet-4-5-20250929

Current Behavior

The Skill tool description shows an empty available skills list:

Available skills:

However, skills exist in .claude/skills/ with proper formatting:

• .claude/skills/anki-eng-card/skill.md
• .claude/skills/anki-polish-card/skill.md

Both skills have correct frontmatter:

---
name: anki-eng-card
description: Creates English-Russian Anki flashcards in Obsidian...
---

Expected Behavior

Skills from .claude/skills/ should be loaded and appear in the "Available skills:" list, allowing them to be invoked via the Skill tool.

Steps to Reproduce

1. Create skills in .claude/skills/<skill-name>/skill.md with proper frontmatter
2. Start Claude Code session
3. Check Skill tool description - skills list is empty
4. Skills cannot be invoked

Root Cause Analysis

Investigation revealed a permissions issue with the Claude Code temp directory:

$ ls -la /tmp/claude/
drwxr-xr-x   3 root root  4096 Dec 21 11:36 .
drwxrwxrwt 106 root root 12288 Jan 10 21:45 ..
drwxr-xr-x   3 root root  4096 Dec 21 11:36 -etc-nixos

The /tmp/claude/ directory is owned by root:root with 755 permissions, preventing non-root users from creating workspace-specific directories like /tmp/claude/-home-gor-obsidian/.

Error observed:

EACCES: permission denied, mkdir '/tmp/claude/-home-gor-obsidian/tasks'

Claude Code appears to need write access to /tmp/claude/ to process and cache skills, but fails silently when it cannot create the necessary directories.

Potential Fixes

1. User workaround: Change ownership of /tmp/claude/ to the current user

   sudo chown -R $USER:$USER /tmp/claude/

2. Claude Code fix: Create temp directories with correct user permissions or handle permission errors gracefully with appropriate error messages

Impact

Users cannot use custom skills even when properly configured, limiting extensibility of Claude Code. This particularly affects NixOS users where system directories may be created with root ownership.

[github-actions]

Found 3 possible duplicate issues:

1. [BUG] Claude Code assistant not aware of available skills in .claude/skills/ directory #9716
2. [BUG] False-positive inode deduplication prevents custom agents and skills from loading #17078
3. [BUG] User-provided skills in ~/.claude/skills/ not appearing in /skills command output #14733

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

[gorbach]

The problem was caused by incorrect case of files. skill.md instead of SKILL.md

[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.