a-ariff

Contributing to Ariff's Claude Code Plugins

Development community intermediate

SOURCE https://github.com/a-ariff/ariff-claude-plugins

Description

Thank you for your interest in contributing! This guide will help you create and submit plugins.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

Repository README

This is the README for a-ariff/ariff-claude-plugins, shared by 2 entries in this directory. It describes the repository, not this entry specifically.

Contributing to Ariff's Claude Code Plugins

Thank you for your interest in contributing! This guide will help you create and submit plugins.

🎯 Before You Start

Check existing plugins to avoid duplicates
Review the Plugin Structure requirements
Test your plugin locally before submitting

📁 Plugin Structure

Every plugin must include:

plugins/your-plugin/
├── manifest.json        # Required: Plugin metadata
├── your-plugin.md       # Required: Main plugin file
└── README.md            # Recommended: Documentation

manifest.json

{
  "name": "your-plugin",
  "version": "1.0.0",
  "description": "Clear, concise description of what your plugin does",
  "category": "agents",
  "tags": ["relevant", "tags"],
  "author": {
    "name": "Your Name",
    "github": "your-username"
  },
  "files": ["your-plugin.md"],
  "dependencies": [],
  "claude_code_version": ">=1.0.0"
}

Categories

Category	File Extension	Description
`agents`	`.agent.md` or `.md`	Autonomous task specialists
`skills`	`.skill.md` or `.md`	Reusable capabilities
`hooks`	`.hook.md` or `.md`	Event-driven automations
`commands`	`.command.md` or `.md`	Custom slash commands

✍️ Writing Guidelines

For Agents

---
name: your-agent
type: agent
description: What this agent specializes in
triggers:
  - keyword patterns that activate this agent
---

# Your Agent Name

## Role
Define the agent's primary role and expertise.

## Capabilities
- List specific capabilities
- Include tools it can use
- Mention any MCP integrations

## Workflow
1. Step-by-step process
2. How it handles tasks
3. Output format

## Examples
Show example interactions.

For Skills

---
name: your-skill
type: skill
description: What capability this adds
---

# Your Skill Name

## Purpose
Why this skill exists and when to use it.

## Technique
Detailed methodology or approach.

## Application
How to apply this skill in practice.

## Examples
Real-world usage examples.

For Hooks

---
name: your-hook
type: hook
trigger: pre-tool-call|post-response|on-error
---

# Your Hook Name

## Trigger Conditions
When this hook activates.

## Actions
What the hook does when triggered.

## Configuration
Any configurable options.

🧪 Testing Your Plugin

**Local Testing**

# Copy to your Claude directory
cp -r plugins/your-plugin ~/.claude/plugins/

# Start a new Claude Code session and test

**Validation**

# Run the plugin checker
bash scripts/validate-plugin.sh plugins/your-plugin

**Checklist**
- manifest.json is valid JSON
- All referenced files exist
- No absolute paths in plugin files
- Works in a fresh Claude Code session
- Doesn't conflict with existing plugins

📤 Submitting Your Plugin

**Fork this repository**
**Cre