agentic-plugin-dev

agentics

A marketplace system for Claude Code plugins, enabling discovery, distribution, and installation of plugins that extend Claude's capabilities.

Quick Start

Install from GitHub (recommended):

# Register the agentics-kit marketplace
/plugin marketplace add shawn-sandy/agentics

# Install any plugin by name
/plugin install code-review@agentics-kit
/plugin install git-agent@agentics-kit

Or load a plugin directly for local testing:

git clone https://github.com/shawn-sandy/agentics.git
cd agentics
claude --plugin-dir ./kit/plugins/code-review
# Then ask: "Review this code for issues"

Overview

The agentics project provides:

• Example Plugins — 11 reference implementations demonstrating Claude Code plugin structure
• Test Marketplace — agentics-kit marketplace for testing plugin discovery and installation
• Plugin Development Guide — Documentation and patterns for creating your own plugins

Prerequisites

Required

• Claude Code CLI (version 1.0.33 or later — required for plugin support)

  # Verify installation
  claude --version
  

Optional Tools

• Git — For cloning the repository
• GitHub CLI (gh) — For the git-agent plugin's PR creation

Platform Support

• macOS 12.0 or later
• Linux (Ubuntu 20.04+ or equivalent)
• Windows (WSL2 recommended for best compatibility)

Project Structure

agentics/
├── kit/
│   ├── .claude-plugin/
│   │   └── marketplace.json          # Marketplace manifest (agentics-kit)
│   └── plugins/                      # Example plugins
│       ├── code-review/              # Code review skill
│       ├── plan-interview/           # Plan stress-test (command + skill)
│       ├── claude-md-optimizer/      # CLAUDE.md audit and optimization
│       ├── wcag-compliance-reviewer/ # WCAG 2.2 accessibility compliance
│       ├── skill-reviewer/           # Skill authoring review and testing
│       ├── code-testing-agent/       # Test suggestion and review
│       ├── git-agent/                # Automated git commit and PR creation
│       ├── agent-creator/            # Agent-based plugin scaffolding
│       ├── react-perf-analyzer/      # React performance analysis
│       ├── marketplace-builder/      # Marketplace scaffolding
│       └── agentic-plugin-dev/       # Plugin creation and management
├── tests/
│   └── fixtures/                     # Test plugin fixtures
└── README.md                         # This file

Installation

1. Clone the repository:

   git clone https://github.com/shawn-sandy/agentics.git
   cd agentics
   

2. Load a plugin directly:

   # Test with code-review plugin
   claude --plugin-dir ./kit/plugins/code-review
   
   # This starts an interactive Claude Code session.
   # Once Claude responds, ask naturally:
   # "Review this code for issues"
   

3. Verify the plugin loaded:

   # In the Claude interactive session, list available commands:
   /help
   

Note: You can test plugins immediately without installing any dependencies. The --plugin-dir flag loads plugins directly from your local filesystem and starts an interactive session.

Troubleshooting

"claude: command not found"

The Claude Code CLI is not installed or not in your PATH.

Solution:

• Install Claude Code from the official source: https://code.claude.com/docs/en/installation
• Verify installation: claude --version
• Ensure you have version 1.0.33 or later (required for plugin support)
• On macOS/Linux: Ensure ~/.local/bin or the installation directory is in your PATH
• On Windows: Use WSL2 and follow Linux installation steps

Plugin not loading

The plugin directory may not exist or the path is incorrect.

Solution:

• Verify the path exists: ls -la ./kit/plugins/code-review
• Use absolute paths if relative paths aren't working:

  claude --plugin-dir /full/path/to/agentics/kit/plugins/code-review
  

• Check that .claude-plugin/plugin.json exists in the plugin directory

Permission errors

The plugin directory or files may not be readable.

Solution:

• Check file permissions: ls -la ./kit/plugins/code-review
• Make directory readable: chmod -R +r ./kit/plugins/code-review
• Ensure you own the files: chown -R $USER:$USER ./kit/plugins/

"Input must be provided" error with --plugin-dir

You see an error like: Error: Input must be provided either through stdin or as a prompt argument when using --print