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
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
-
Clone the repository:
git clone https://github.com/shawn-sandy/agentics.git
cd agentics
-
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"
-
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:
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
