[BUG] Claude Code can't seem to be able to load the skills, agents and subagents automatically.

[marcel-Ngan]

By following the guide, Claude Code can't seem to load Claude Code Tresor automatically.
These are the problems it has found.
Problem 1: Skills Directory Structure is Too Nested

Current structure:
.claude/skills/engineering-team/code-reviewer/SKILL.md ❌
.claude/skills/product-team/product-strategist/SKILL.md ❌

Expected structure:
.claude/skills/code-reviewer/SKILL.md ✅
.claude/skills/product-strategist/SKILL.md ✅

Claude Code looks for skills at .claude/skills/{skill-name}/SKILL.md (one level), but yours are nested two levels deep.

---

Problem 2: Agents Should Be Flat .md Files

Current structure:
.claude/agents/security-auditor/agent.md ❌ (symlink to subagents)
.claude/subagents/core/security-auditor/agent.md ❌

Expected structure:
.claude/agents/security-auditor.md ✅
.claude/agents/test-engineer.md ✅

Agents should be single .md files directly in .claude/agents/, not directories with agent.md inside.

---

Problem 3: Non-Standard YAML Frontmatter Fields

Your subagent files include unsupported fields:
category: "engineering" ❌ Not supported
team: "engineering" ❌ Not supported
color: "#3B82F6" ❌ Not supported
subcategory: "languages" ❌ Not supported
capabilities: [...] ❌ Not supported
max_iterations: 50 ❌ Not supported

Supported fields:
name: agent-name ✅
description: ... ✅
tools: Read, Edit, Grep ✅
model: sonnet ✅ (opus, sonnet, haiku, inherit)

[alirezarezvani]

✅ All 3 Problems Fixed!

Thank you for the detailed bug report! I've identified and fixed all 3 critical compatibility issues preventing Claude Code from loading Tresor.

---

Problem 1: Skills Directory Structure ✅ FIXED

Issue: Skills nested 2 levels deep (skills/category/skill-name) vs Claude Code expecting 1 level (skills/skill-name)

Fix: Updated install_skills() to flatten structure:

# Now installs as:
.claude/skills/code-reviewer/SKILL.md ✓
.claude/skills/security-auditor/SKILL.md ✓
# Instead of:
.claude/skills/development/code-reviewer/SKILL.md ❌

---

Problem 2: Agents Should Be Flat .md Files ✅ FIXED

Issue: Agents installed as directories (agents/agent-name/agent.md) vs Claude Code expecting flat files (agents/agent-name.md)

Fix: Updated install_agents() to create flat files:

# Now installs as:
.claude/agents/systems-architect.md ✓ (flat file)
.claude/agents/security-auditor.md ✓ (flat file)
# Instead of:
.claude/agents/systems-architect/agent.md ❌ (directory)

---

Problem 3: Non-Standard YAML Frontmatter ✅ FIXED

Issue: Agent files contained unsupported fields (category, team, color, capabilities, max_iterations)

Fix: Added AWK script to strip unsupported fields during installation:

Removed Fields:

• category: - Tresor-specific
• team: - Tresor-specific
• color: - Tresor-specific
• capabilities: - Tresor-specific
• max_iterations: - Tresor-specific

Kept Fields:

• name: ✅
• description: ✅
• tools: ✅
• model: ✅
• enabled: ✅

---

How to Get the Fixes

Update Your Installation

# Navigate to Tresor repository
cd /path/to/claude-code-tresor

# Pull latest fixes
git pull origin main

# Reinstall with fixed scripts
./scripts/install.sh

Or use update script:

./scripts/update.sh

---

What's Fixed

Files Modified:

• scripts/install.sh - Fixed all 3 issues
• scripts/update.sh - Matched install.sh fixes
• CLAUDE-CODE-COMPATIBILITY-FIXES.md - Complete documentation

Commit: 7c59085
Branch: feature/slash-commands-updates-11-2025 → dev → main

---

Verification

After reinstalling, verify:

1. Skills Load Correctly:

ls ~/.claude/skills/
# Should show: code-reviewer/, test-generator/, security-auditor/, etc.
# (One level deep, no category directories)

2. Agents Load Correctly:

ls ~/.claude/agents/
# Should show: systems-architect.md, security-auditor.md, etc.
# (Flat .md files, NOT directories)

3. YAML is Clean:

head -10 ~/.claude/agents/systems-architect.md
# Should only show: name, description, tools, model, enabled
# (NO category, team, color, capabilities, max_iterations)

4. Claude Code Loads Them:

# In Claude Code:
@systems-architect --help
# Should work! ✓

---

Timeline

Fixes are in: feature/slash-commands-updates-11-2025 branch
Status: Ready for merge to dev → main
ETA: Available after next release

---

Thank you again for the detailed report - this was a critical issue affecting all users!

Let me know if you have any questions or if the fixes work for you after reinstalling.

[alirezarezvani]

@marcel-Ngan Hi,

Thank you for reporting the 3 issues. I have solved them and hope it works now for you.

[marcel-Ngan]

Looks good. The same update will also be needed in claude-skills.

[alirezarezvani]

✅ UPDATE: All Fixes Are Now in Dev Branch!

The critical compatibility fixes have been merged to the dev branch and are ready for testing!

---

🎉 Status

All 3 Problems: ✅ FIXED and merged to dev
Merge: PR #42 ("Dev into main - issue #40 fixes")
Branch: Available in dev branch now
Next: Will be in main after next release

---

📥 How to Get the Fixes NOW

Option 1: Install from Dev Branch (Latest)

# Clone from dev branch
git clone -b dev https://github.com/alirezarezvani/claude-code-tresor.git
cd claude-code-tresor

# Install with fixed scripts
./scripts/install.sh

Option 2: Update Existing Installation to Dev

# Navigate to existing installation
cd /path/to/claude-code-tresor

# Switch to dev branch
git fetch origin
git checkout dev
git pull origin dev

# Reinstall with fixes
./scripts/install.sh

---

✅ Verification

After installing from dev, verify the fixes worked:

1. Skills (Should be 1 level deep):

ls ~/.claude/skills/
# Expected: code-reviewer/, test-generator/, security-auditor/, etc.
# NOT: development/code-reviewer/ ❌

2. Agents (Should be flat .md files):

ls ~/.claude/agents/
# Expected: systems-architect.md, security-auditor.md, etc.
# NOT: systems-architect/agent.md ❌

3. YAML (Should be clean):

head -10 ~/.claude/agents/systems-architect.md
# Should show ONLY: name, description, tools, model, enabled
# Should NOT show: category, team, color, capabilities, max_iterations

4. Claude Code Integration:

# Start Claude Code
claude-code

# Test agent invocation:
@systems-architect Design a scalable system
# Should work! ✓

---

📦 What Was Fixed

scripts/install.sh:

• Skills now flatten from 2 levels → 1 level
• Agents now install as flat .md files (not directories)
• AWK script strips unsupported YAML fields automatically

scripts/update.sh:

• Same fixes applied for updates

Documentation:

• CLAUDE-CODE-COMPATIBILITY-FIXES.md with complete technical details

---

📅 Timeline

Now: Available in dev branch
Soon: Will be in main branch after release cycle
Recommendation: Use dev branch for immediate fix

---

🙏 Thank You!

Your detailed bug report was invaluable - it identified critical issues affecting all Tresor users. The fixes are now in dev and will benefit everyone!

Please test the dev branch fixes and let us know if everything works correctly for you.

---

Questions or issues? Reply to this thread!