plugin-structure

Agent SkillsFreeOpen Source

Guidance for scaffolding Claude Code plugins: directory layout, plugin.json manifest, and component auto-discovery.

🛡️ AgentReady threat assessment

MAESTRO 7-layer threat model + OWASP AIVSS risk score for plugin-structure, derived from its capabilities.

AIVSS 4.0 · Medium

Overview

Part of the plugin-dev plugin, this skill explains Claude Code plugin architecture: directory layout, the plugin.json manifest, the ${CLAUDE_PLUGIN_ROOT} variable, how to add commands/agents/skills/hooks, and how auto-discovery and file-naming conventions work. It provides the structural best practices needed to create or organize a plugin.

Key features

plugin.json manifest configuration
Component auto-discovery layout
File-naming and organization conventions

Use cases

Scaffold a new Claude Code plugin
Reorganize a plugin's components correctly