From architect
Schema knowledge for scaffolding Claude Code plugins with marketplace.json and plugin.json validation. Use when creating new plugins, validating plugin structure, or registering plugins in the marketplace.
npx claudepluginhub lunarmoon26/star-digital-employee --plugin architectThis skill uses the workspace's default tool permissions.
This skill provides verified schema information for scaffolding Claude Code plugins in the star-digital-employee project. All field definitions are derived from existing, working entries - never add fields not documented here.
Scaffolds Claude Code plugins for commands, agents, skills, and MCP with directory structure, required files, marketplace integration, and validation scripts.
Guides developers in creating, scaffolding, validating, and publishing Claude Code plugins including directory structure, plugin.json schema, YAML frontmatter, agents, commands, skills, and marketplace deployment.
Generates Claude Code plugin structures, creates/updates plugin.json and marketplace.json manifests, adds components like commands/skills/agents/hooks, bumps versions, and sets up testing/publishing workflows.
Share bugs, ideas, or general feedback.
This skill provides verified schema information for scaffolding Claude Code plugins in the star-digital-employee project. All field definitions are derived from existing, working entries - never add fields not documented here.
Plugins in this project live in two locations:
| Location | Purpose | Example |
|---|---|---|
plugins/ | First-party plugins created for this collection | developer, researcher, sample-plugin |
external_plugins/ | Third-party or forked plugins | deepwiki |
When scaffolding a new plugin, always ask the user which folder is appropriate:
Every plugin follows this structure:
[plugin-name]/
├── .claude-plugin/
│ └── plugin.json # Required: Plugin manifest
├── commands/ # Optional: Slash commands
│ └── *.md
├── skills/ # Optional: Skill definitions
│ └── [skill-name]/
│ └── SKILL.md
├── agents/ # Optional: Subagent definitions
│ └── *.md
├── hooks/ # Optional: Event hooks
│ └── *.md
└── README.md # Recommended: Documentation
| Element | Convention | Example |
|---|---|---|
| Plugin name | kebab-case | my-awesome-plugin |
| Folder name | Same as plugin name | my-awesome-plugin/ |
| Version | Semantic versioning | 0.1.0, 1.2.3 |
| Command files | kebab-case | scaffold-plugin.md |
| Skill folders | kebab-case | plugin-scaffolding/ |
The plugin manifest is located at [plugin-name]/.claude-plugin/plugin.json.
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Unique plugin identifier in kebab-case |
version | string | Recommended | Semantic version (e.g., "0.1.0") |
description | string | Recommended | Brief description of plugin purpose |
author | object | Optional | Author information |
author.name | string | Yes (if author) | Author's display name |
author.email | string | Optional | Author's email address |
keywords | array | Optional | Array of keyword strings for discoverability |
{
"name": "my-plugin",
"version": "0.1.0",
"description": "A helpful plugin that does useful things",
"author": {
"name": "Haochuan Zhang",
"email": "jackchang26@gmail.com"
},
"keywords": ["utility", "automation", "productivity"]
}
The marketplace registry is at .claude-plugin/marketplace.json in the project root.
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Must match plugin.json name |
description | string | Yes | Can differ from plugin.json (marketplace-specific) |
version | string | Yes | Must match plugin.json version |
source | string or object | Yes | Path to plugin (e.g., "./plugins/my-plugin") |
category | string | Yes | One of: development, research, productivity, example, integration |
author | object | Optional | Author information |
author.name | string | Yes (if author) | Author's display name |
author.email | string | Optional | Author's email address |
homepage | string | Optional | URL to plugin documentation/repo |
{
"name": "my-plugin",
"description": "A helpful plugin that does useful things",
"version": "0.1.0",
"author": {
"name": "Haochuan Zhang",
"email": "jackchang26@gmail.com"
},
"source": "./plugins/my-plugin",
"category": "productivity",
"homepage": "https://github.com/lunarmoon26/star-digital-employee/tree/main/plugins/my-plugin"
}
0.1.0./plugins/[name] or ./external_plugins/[name]source and url fieldsNEVER add fields not documented in this skill. The schemas above represent the complete set of verified fields from existing, working entries. Adding unverified fields may break compatibility or cause validation errors.
If you encounter a field not listed here:
When scaffolding plugins, this skill works alongside Claude's official plugin-dev:create-plugin workflow:
The recommended workflow: