Agent skill · software engineering · jeremylongshore
clade-reference-architecture
Build Claude Code plugins \u2014 skills, agents, MCP servers, hooks,\
Why this skill is useful
Adds executable scripts and detailed patterns for building Claude Code plugins, extending capabilities beyond standard knowledge.
What it needs
Requires node installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Claude Code Plugin Architecture Overview Claude Code has a plugin system with 4 extension points: skills (auto-activating knowledge), commands (slash commands), agents (specialized sub-agents), and MCP servers (tool providers). This skill covers building all four. Prerequisites A supported Claude Code environment and an isolated plugin workspace A declared ownership boundary for filesystem, network, and credential access Validation tooling for manifests, skill metadata, commands, agents, and MCP A rollback plan that can disable a plugin without deleting user state Instructions Start with the smallest extension point that meets the requirement, declare only the tools and permissions it needs, and validate it locally before adding it to a marketplace or shared environment. Test discovery, activation, failure, and rollback paths; do not expose secrets through examples, environment files, logs, or MCP response payloads. Plugin Structure Building a Skill (SKILL.md) Building a Slash Command Building an Agent Building an MCP Server Hooks Path Variables Variable Context Resolves To ---------- --------- ------------- ${CLAUDESKILLDIR} Skills (bash/DCI) Skill's directory ${CLAUDEPLUGINROOT} Hooks Plugin root directory ${CLAUDEPLUGINDATA} Persistent state Survives updates $ARGUMENTS Commands User-provided args Error Handling Condition Response --- --- Manifest or metadata validation fails Stop installation, correct the declared contract, and rerun validation. Plugin requests unapproved capability Remove or narrowly justify the capability before release. MCP server fails or returns malformed data Fail closed, redact diagnostic output, and preserve a correlation ID. Upgrade changes plugin behavior Disable or pin the new version and restore the last tested release. Output Produce a plugin architecture record identifying the chosen extension point, manifest version, declared tools/permissions, test evidence, release owner, and rollback procedure. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/clade-reference-architecture--2a40ac