Commit 2f2d191
docs: add ${CLAUDE_PLUGIN_ROOT} explanation to marketplace-structure skill (#97)
## Summary
Add explanatory note for the `${CLAUDE_PLUGIN_ROOT}` environment
variable in the marketplace-structure skill's schema reference
documentation.
## Problem
Fixes #95
The `${CLAUDE_PLUGIN_ROOT}` environment variable is used in the hooks
and mcpServers examples within the Complete Plugin Entry Example, but
wasn't explicitly explained. Users unfamiliar with plugin development
may not understand what this variable represents.
## Solution
Added a brief note directly before the Complete Plugin Entry Example
that explains:
- What `${CLAUDE_PLUGIN_ROOT}` resolves to (plugin's absolute
installation path)
- When to use it (hooks and MCP server configurations)
- Why it matters (portable paths regardless of installation location)
This approach was chosen over adding a new subsection because:
1. It's contextual - explains the variable right where it's used
2. Simpler and less intrusive to the document structure
3. Provides just-in-time information for users reading the example
### Alternatives Considered
- **New "### Environment Variables" subsection** after Component
Configuration Fields - More prominent but disrupts document flow and may
be overkill for a single variable note
- **Inline code comment** in the JSON example - Would require multiple
comments and break JSON syntax highlighting
## Changes
-
`plugins/plugin-dev/skills/marketplace-structure/references/schema-reference.md`:
Added note before Complete Plugin Entry Example explaining
`${CLAUDE_PLUGIN_ROOT}`
## Testing
- [x] markdownlint passes
- [x] No other files affected
---
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>1 parent 2644125 commit 2f2d191
1 file changed
Lines changed: 2 additions & 0 deletions
Lines changed: 2 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
150 | 150 | | |
151 | 151 | | |
152 | 152 | | |
| 153 | + | |
| 154 | + | |
153 | 155 | | |
154 | 156 | | |
155 | 157 | | |
| |||
0 commit comments