frontend-dev

You: "Read the auth module, check for SQL injection, review the error handling,
     look at the input validation, check the session management..."

You: "Run a security review on the auth module"
Claude: *security-analyst agent handles everything autonomously*

git clone https://github.com/a-ariff/ariff-claude-plugins.git
cd ariff-claude-plugins && bash scripts/install.sh

git clone https://github.com/a-ariff/ariff-claude-plugins.git
cd ariff-claude-plugins; .\scripts\install.ps1

ariff-claude-plugins/
|
|-- 24 Agents      autonomous workers that handle entire tasks
|-- 34 Skills      methodologies and knowledge you can apply on demand
|--  5 Hooks       automatic safeguards that run without you asking
|--  2 Commands    slash commands for common workflows
|
|-- includes 12-plugin Anti-Hallucination Suite

claude --version

git clone https://github.com/a-ariff/ariff-claude-plugins.git
cd ariff-claude-plugins

bash scripts/install.sh

# Run from PowerShell (not CMD)
cd ariff-claude-plugins

# Create plugin directories
$claudeDir = "$env:USERPROFILE\.claude"
New-Item -ItemType Directory -Force -Path "$claudeDir\agents"
New-Item -ItemType Directory -Force -Path "$claudeDir\skills"
New-Item -ItemType Directory -Force -Path "$claudeDir\hooks"
New-Item -ItemType Directory -Force -Path "$claudeDir\commands"
New-Item -ItemType Directory -Force -Path "$claudeDir\scripts"

# Copy all plugins
Get-ChildItem plugins -Directory | ForEach-Object {
    $plugin = $_
    # Agents
    if (Test-Path "$($plugin.FullName)\agents") {
        Copy-Item "$($plugin.FullName)\agents\*.md" "$claudeDir\agents\" -Force
    }
    # Skills (directories)
    if (Test-Path "$($plugin.FullName)\skills") {
        Get-ChildItem "$($plugin.FullName)\skills" -Directory | ForEach-Object {
            $dest = "$claudeDir\skills\$($_.Name)"
            New-Item -ItemType Directory -Force -Path $dest | Out-Null
            Copy-Item "$($_.FullName)\*" $dest -Force
        }
        # Skills (flat .md files)
        Get-ChildItem "$($plugin.FullName)\skills\*.md" -ErrorAction SilentlyContinue | ForEach-Object {
            $skillName = $_.BaseName -replace '\.skill$',''
            $dest = "$claudeDir\skills\$skillName"
            New-Item -ItemType Directory -Force -Path $dest | Out-Null
            Copy-Item $_.FullName "$dest\SKILL.md" -Force
        }
    }
    # Hooks
    if (Test-Path "$($plugin.FullName)\hooks\hooks.json") {
        Copy-Item "$($plugin.FullName)\hooks\hooks.json" "$claudeDir\hooks\$($plugin.Name)-hooks.json" -Force
    }
    # Commands
    if (Test-Path "$($plugin.FullName)\commands") {
        Copy-Item "$($plugin.FullName)\commands\*.md" "$claudeDir\commands\" -Force -ErrorAction SilentlyContinue
    }
    # Scripts
    if (Test-Path "$($plugin.FullName)\scripts") {
        Copy-Item "$($plugin.FullName)\scripts\*" "$claudeDir\scripts\" -Force -ErrorAction SilentlyContinue
    }
    Write-Host "  ok  $($plugin.Name)" -ForegroundColor Green
}

Write-Host "`nInstalled all plugins to $claudeDir" -ForegroundColor Cyan

# If using WSL or Git Bash, the bash script works directly
bash scripts/install.sh

claude

/browse

    You clone the repo          Install script copies          Claude Code
    to your machine             components to ~/.claude/       reads them
                                (or %USERPROFILE%\.claude\
                                 on Windows)

    ariff-claude-plugins/       ~/.claude/
    |-- plugins/                |-- agents/     (22 files)
    |   |-- architect/    -->   |-- skills/     (26 dirs)
    |   |-- security/     -->   |-- hooks/      (3 configs)
    |   |-- debugger/     -->   |-- commands/   (2 files)
    |   |-- ...53 total         |-- scripts/    (hook scripts)
    |                           |
    |-- scripts/                Claude Code loads these
    |   |-- install.sh          automatically on startup
    |   |-- install.ps1

bash scripts/install.sh --plugin architect
bash scripts/install.sh --plugin security-analyst

# Example: install just the architect agent
$claudeDir = "$env:USERPROFILE\.claude\agents"
New-Item -ItemType Directory -Force -Path $claudeDir | Out-Null
Copy-Item plugins\architect\agents\*.md $claudeDir -Force

cd ariff-claude-plugins
git pull origin main
bash scripts/install.sh

cd ariff-claude-plugins
git pull origin main
# Re-run the PowerShell install block from Step 3

bash scripts/install.sh --uninstall

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\agents"
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\skills"
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\hooks"
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\commands"
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\scripts"

+-------------------+     +-------------------+     +-------------------+
|                   |     |                   |     |                   |
|  You: "review     |---->|  Claude selects   |---->|  security-analyst |
|  this code for    |     |  security-analyst |     |  reads code,      |
|  vulnerabilities" |     |  agent            |     |  checks OWASP,    |
|                   |     |                   |     |  reports findings  |
+-------------------+     +-------------------+     +-------------------+

"Design a caching layer for my high-traffic API"
  -> architect agent handles system design

"Review this code for security vulnerabilities"
  -> security-analyst agent runs a full review

"Optimize this database query that's taking 3 seconds"
  -> performance-engineer agent profiles and fixes it

"Plan the implementation for this new feature"
  -> project-planner agent breaks it down into steps

"Help me understand how this authentication flow works"
  -> mentor agent explains at your level

"Use the systematic-debugger skill to find this memory leak"
"Apply the brainstorming skill to generate API design alternatives"
"Use verification-before-completion for this deployment"

/deep-search "react server components best practices"
/task-folder-manager --name "feature-auth-rewrite"

+------------------+     +--------------------+     +------------------+
|                  |     |                    |     |                  |
|  Claude is about |---->|  assumption-checker|---->|  "Warning: you   |
|  to use a tool   |     |  hook fires        |     |  assumed X, did  |
|                  |     |  (PreToolUse)      |     |  you verify it?" |
+------------------+     +--------------------+     +------------------+

flowchart TD
    A["You start Claude Code"] --> B["Claude reads ~/.claude/"]
    B --> C["agents/*.md"]
    B --> D["skills/*/SKILL.md"]
    B --> E["hooks/*.json"]
    B --> F["commands/*.md"]

    C --> G["Loaded on demand\nwhen task matches"]
    D --> H["Descriptions loaded\nfull content on invoke"]
    E --> I["Always active\nfires on matching events"]
    F --> J["Available as\n/slash-commands"]

    style A fill:#4CAF50,color:#fff
    style B fill:#2196F3,color:#fff
    style G fill:#FF9800,color:#fff
    style H fill:#FF9800,color:#fff
    style I fill:#f44336,color:#fff
    style J fill:#9C27B0,color:#fff

pie title 65 Plugins by Category
    "Agents (24)" : 24
    "Skills (34)" : 34
    "Hooks (5)" : 5
    "Commands (2)" : 2

flowchart LR
    A["git clone"] --> B["cd ariff-claude-plugins"]
    B --> C{Your OS?}
    C -->|macOS/Linux| D["bash scripts/install.sh"]
    C -->|Windows| E[".\scripts\install.ps1"]
    C -->|WSL| D
    D --> F["~/.claude/"]
    E --> G["%USERPROFILE%\.claude\"]
    F --> H["65 plugins ready"]
    G --> H

    style A fill:#4CAF50,color:#fff
    style H fill:#4CAF50,color:#fff
    style C fill:#2196F3,color:#fff

sequenceDiagram
    participant You
    participant Claude
    participant Agent

    You->>Claude: "review this code for vulnerabilities"
    Claude->>Claude: Selects security-analyst agent
    Claude->>Agent: Delegates task
    Agent->>Agent: Reads code files
    Agent->>Agent: Checks OWASP patterns
    Agent->>Agent: Analyzes attack surface
    Agent->>Claude: Returns findings
    Claude->>You: Structured security report

my-plugin/
  .claude-plugin/
    plugin.json          # manifest (name, version, description)
  agents/                # agent definitions (markdown)
  skills/                # skill definitions (markdown)
  hooks/
    hooks.json           # hook event configuration
  commands/              # slash command definitions
  scripts/               # shell scripts for hooks