docs: sync plugin-development documentation with official Anthropic docs #5
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Add missing frontmatter fields: name, tools, model, permissionMode, skills - Document model options: sonnet, opus, haiku, inherit - Document permission modes: default, acceptEdits, bypassPermissions, plan - Remove deprecated 'capabilities' field (not in official docs) - Update agent-template.md with complete frontmatter reference - Update plugin-reviewer.md with official field structure - Update add-agent.md command with comprehensive field documentation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Add missing event types: Notification, PreCompact, PermissionRequest - Add CLAUDE_ENV_FILE environment variable for SessionStart - Document hook types: command, prompt, agent - Expand JSON output format with hookSpecificOutput structure - Add MCP tool matching pattern: mcp__<server>__<tool> - Document decision field for PostToolUse/Stop/SubagentStop 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Add missing component fields: lspServers, outputStyles - Fix agents path rule to allow both directory and array formats - Add hook types documentation: command, prompt, agent - Expand hook events list with all 10 official events - Add LSP Server Configuration section with examples - Add hook matchers section with MCP tool patterns - Remove incorrect 'Common Mistakes' about agents directory paths 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Add model frontmatter field for specifying Claude model - Fix name validation: lowercase letters, numbers, and hyphens - Add reserved word restrictions: cannot contain 'anthropic' or 'claude' - Add XML tag restrictions for name and description - Add SKILL.md size guidance: 500 lines max for optimal performance - Update allowed-tools to document auto-approval behavior 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Add model frontmatter field for specifying different model - Add disable-model-invocation field to prevent SlashCommand tool access - Document @path/to/file syntax for including file contents - Add pipe syntax for argument-hint with multiple patterns - Add SlashCommand tool section with character budget (15,000 chars) - Document SLASH_COMMAND_TOOL_CHAR_BUDGET environment variable 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
…ttings - Add lspServers to component configuration fields - Document GitHub source optional fields: ref (branch/tag) and path (subdirectory) - Add Enterprise Marketplace Restrictions section with strictKnownMarketplaces - Add Reserved Marketplace Names section with blocked names list - Remove undocumented simple URL string formats - Update advanced plugin entry example with lspServers configuration 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
There was a problem hiding this comment.
Pull request overview
This pull request synchronizes the plugin-development documentation with the latest official Anthropic Claude Code documentation. It comprehensively updates schemas, templates, and guides to reflect current best practices and newly available features.
Key changes:
- Updates agent and skill templates to include proper frontmatter fields (name, tools, model, permissionMode, skills) and removes the deprecated
capabilitiesfield - Expands hooks schema with missing event types (Notification, PreCompact, PermissionRequest), adds CLAUDE_ENV_FILE environment variable, and documents hook-specific JSON output formats
- Adds LSP server configuration documentation and fixes agents path rules to support both directory and array formats
Reviewed changes
Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| plugins/plugin-development/skills/plugin-authoring/templates/skill-template.md | Adds model field, updates allowed-tools description, includes XML tag restrictions, adds 500-line best practice guidance |
| plugins/plugin-development/skills/plugin-authoring/templates/agent-template.md | Removes deprecated capabilities field, adds required name field and optional tools/model/permissionMode/skills fields with comprehensive documentation |
| plugins/plugin-development/skills/plugin-authoring/schemas/plugin-manifest.md | Fixes agents path rule to support directory format, adds lspServers and outputStyles fields, expands hook types and events documentation |
| plugins/plugin-development/skills/plugin-authoring/schemas/marketplace-schema.md | Adds lspServers component config, GitHub source ref/path fields, strictKnownMarketplaces enterprise setting, and reserved marketplace names |
| plugins/plugin-development/skills/plugin-authoring/schemas/hooks-schema.md | Adds three missing event types, documents hook types (command/prompt/agent), adds CLAUDE_ENV_FILE for SessionStart, expands JSON output format with hookSpecificOutput structure |
| plugins/plugin-development/skills/plugin-authoring/SKILL.md | Updates skill naming rules to include XML tag restrictions and reserved word validation, adds model field documentation |
| plugins/plugin-development/commands/add-command.md | Adds model and disable-model-invocation frontmatter fields, documents @path/to/file syntax, adds comprehensive SlashCommand tool section with 15,000 character budget |
| plugins/plugin-development/commands/add-agent.md | Updates agent template to include name field and replace capabilities with tools/model/permissionMode/skills fields, adds permission modes and model options tables |
| plugins/plugin-development/agents/plugin-reviewer.md | Removes deprecated capabilities field, adds required name/tools/model/permissionMode frontmatter to align with new schema |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
plugins/plugin-development/skills/plugin-authoring/schemas/marketplace-schema.md
Outdated
Show resolved
Hide resolved
- Shorten verbose agent template comment block - Format skills name validation as bulleted list for readability - Clarify model format: commands use full IDs, agents use short forms - Add idle_prompt timing note (60s is system default, not configurable) - Add migration note for marketplace path field - Fix LSP config: use extensionToLanguage instead of languages 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
capabilitiesfield from agent templatesChanges by Area
Agents Documentation
name,tools,model,permissionMode,skillssonnet,opus,haiku,inheritdefault,acceptEdits,bypassPermissions,plancapabilitiesfield (not in official docs)Hooks Schema
Notification,PreCompact,PermissionRequestCLAUDE_ENV_FILEenvironment variablecommand,prompt,agenthookSpecificOutputstructurePlugin Manifest Schema
lspServers,outputStylesSkills Documentation
modelfrontmatter fieldanthropic,claude)Commands Documentation
modelanddisable-model-invocationfrontmatter fields@path/to/filesyntax for including file contentsMarketplace Schema
lspServerscomponent configurationrefandpathoptional fieldsstrictKnownMarketplacesenterprise settingTest plan
🤖 Generated with Claude Code