[DOCS] Missing skills field in Component configuration fields documentation

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://docs.claude.com/en/plugin-marketplaces#plugin-entries, https://docs.claude.com/en/plugins-reference#component-path-fields

Section/Topic

Plugin entries - Component configuration fields

Current Documentation

The "Component configuration fields" table currently states:

| Field | Type | Description |
|------------|---------------|--------------------------------------------------|
| commands | string|array | Custom paths to command files or directories |
| agents | string|array | Custom paths to agent files |
| hooks | string|object | Custom hooks configuration or path to hooks file |
| mcpServers | string|object | MCP server configurations or path to MCP config |

The skills field is not documented in this table or anywhere else in the plugin configuration.

What's Wrong or Missing?

The skills component configuration field is missing from the documentation, despite:

1. Skills being a documented plugin component with dedicated sections in the docs
2. Following the same pattern as commands and agents (custom path configuration)
3. Being actively used in the official anthropics/skills marketplace repository

The anthropics/skills marketplace.json uses this field:

  {
    "name": "document-skills",
    "skills": [
      "./document-skills/xlsx",
      "./document-skills/docx",
      "./document-skills/pptx",
      "./document-skills/pdf"
    ]
  }

Suggested Improvement

Add the skills field to the Component configuration fields table in both locations:

In the Plugin marketplaces guide (https://docs.claude.com/en/plugin-marketplaces#plugin-entries):

| Field | Type | Description |
|------------|---------------|--------------------------------------------------|
| commands | string|array | Custom paths to command files or directories |
| agents | string|array | Custom paths to agent files |
| skills | string|array | Custom paths to skill directories |
| hooks | string|object | Custom hooks configuration or path to hooks file |
| mcpServers | string|object | MCP server configurations or path to MCP config |

In the Plugins reference (https://docs.claude.com/en/plugins-reference#component-path-fields):

Add to the "Component path fields" table with example:

| Field | Type | Description | Example |
|------------|---------------|--------------------------------------|-----------------------------
-------|
| commands | string|array | Additional command files/directories | "./custom/cmd.md" or ["./cmd1.md"] |
| agents | string|array | Additional agent files | "./custom/agents/" |
| skills | string|array | Additional skill directories | "./custom/skills/" or ["./skill1"] |
| hooks | string|object | Hook config path or inline config | "./hooks.json" |
| mcpServers | string|object | MCP config path or inline config | "./mcp.json" |

Also add to the "Path behavior rules" section:

• Custom skill paths supplement the default skills/ directory
• Skill paths should point to directories containing SKILL.md files or subdirectories with skills

Impact

Low - Minor confusion or inconvenience

Additional Context

• anthropics/skills marketplace using this field:

https://github.com/anthropics/skills/blob/main/.claude-plugin/marketplace.json

• Skills are documented extensively in the Skills guide: https://docs.claude.com/en/skills
• Skills directory structure is documented in Plugins reference:

https://docs.claude.com/en/plugins-reference#plugin-directory-structure

• The pattern is consistent with other component configuration fields (commands, agents)