anthropics / anthropics/skills

Plugin skills not loaded in Claude Code when installed via marketplace: Missing skills/ directory structure

Aperta
#67 1 commento 5 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
Python
Stelle
176k
Fork
20.8k
Merge medio
7h 21m
PR unite (30g)
5

Descrizione

## Problem

Skills from this repository installed **via the official Claude Code marketplace feature** are **not loaded** by Claude Code, resulting in progressive disclosure not working.

## Installation Method

**Installed using:** Official Claude Code marketplace functionality ()
**NOT:** Manual git clone

The marketplace correctly installs the plugin to:
`~/.claude/plugins/marketplaces/anthropic-agent-skills/`

And shows in settings:
```json
"enabledPlugins": {
"document-skills@anthropic-agent-skills": true,
"example-skills@anthropic-agent-skills": true
}
```

## Environment

- Claude Code Version: Latest (2025-10-27)
- OS: macOS Darwin 24.6.0
- Installation: Via `/plugin marketplace add anthropics/skills`

## Debug Evidence

From `~/.claude/debug/latest`:

```
[DEBUG] Loading plugin document-skills from source: "./"
[DEBUG] Loading plugin example-skills from source: "./"
[DEBUG] Loaded 2 skills total (managed: 0, user: 2, project: 0)
[DEBUG] Total plugin skills loaded: 0 ← ❌ Problem!
```

User skills (manually placed in `~/.claude/skills/`) work fine: **2 loaded**
Plugin skills: **0 loaded**

## Root Cause

According to the [Claude Code Plugin documentation](https://docs.claude.com/en/docs/claude-code/plugins), plugins must have this structure:

```
my-plugin/
├── .claude-plugin/
│ └── plugin.json
├── skills/ ← ⚠️ REQUIRED
│ ├── skill-1/
│ │ └── SKILL.md
│ └── skill-2/
│ └── SKILL.md
```

**However, this repository (when installed via marketplace) has:**

```
anthropic-agent-skills/
├── .claude-plugin/
│ └── marketplace.json
├── mcp-builder/ ← ❌ Directly in root!
│ └── SKILL.md
├── document-skills/
│ ├── xlsx/
│ │ └── SKILL.md
├── skill-creator/
│ └── SKILL.md
```

The `marketplace.json` references skills with paths like:
```json
"skills": [
"./mcp-builder",
"./skill-creator",
"./document-skills/xlsx"
]
```

But Claude Code expects them under a `skills/` subdirectory to be loaded.

## Impact

- ❌ **Progressive disclosure does not work** - Skills are not automatically loaded into Claude's context
- ❌ **All marketplace skills affected** - mcp-builder, skill-creator, document-skills (xlsx, docx, pptx, pdf), canvas-design, algorithmic-art, webapp-testing, artifacts-builder, slack-gif-creator, theme-factory, brand-guidelines
- ❌ **Manual workaround required** - Users must manually copy skills to `~/.claude/skills/`
- ❌ **Inconsistent with documentation** - Official Anthropic repository doesn't follow official plugin structure documentation

## Expected Behavior

When plugins are enabled via marketplace installation:
1. Skills should be automatically discovered
2. Progressive disclosure should work (Skills loaded automatically based on semantic relevance)
3. Debug log should show: `Total plugin skills loaded: 10+`

## Proposed Solutions

1. **Restructure repository** - Add a `skills/` directory and move all skills into it
2. **Update Claude Code** - Support marketplace-specific flat structure (if intentional)
3. **Update documentation** - Clarify that marketplace structure differs from standard plugin structure

## Workaround

Manually copy skills to user directory:
```bash
cp -r ~/.claude/plugins/marketplaces/anthropic-agent-skills/mcp-builder ~/.claude/skills/
cp -r ~/.claude/plugins/marketplaces/anthropic-agent-skills/skill-creator ~/.claude/skills/
cp -r ~/.claude/plugins/marketplaces/anthropic-agent-skills/document-skills ~/.claude/skills/
# etc.
```

After copying, Claude Code correctly loads them:
```
[DEBUG] Loaded 5 skills total (managed: 0, user: 5, project: 0)
```

---

**This is a critical issue** as it prevents the core functionality (progressive disclosure) of Skills from working for users who install via the official marketplace method.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.