Skip to content
Back to search

mag-claude-plugins

MarketplaceWorks with Claude CodeGitHub

claude code plugins marketplace

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/madappgang-claude-code/badge.svg)](/listings/madappgang-claude-code)

HTML

<a href="/listings/madappgang-claude-code"><img src="/api/listings/madappgang-claude-code/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Recommended Setup:** Add marketplace globally, enable plugins per-project.

# Step 1: Add marketplace globally (one-time setup)
/plugin marketplace add MadAppGang/claude-code

Then add to your project's `.claude/settings.json`:

{
  "enabledPlugins": {
    "frontend@mag-claude-plugins": true,
    "code-analysis@mag-claude-plugins": true,
    "bun@mag-claude-plugins": true,
    "orchestration@mag-claude-plugins": true
  }
}

**That's it!** The plugins are now enabled for this project. Commit `.claude/settings.json` so your team gets the same setup automatically.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 257 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "mag-claude-plugins",
  3. "owner": {
  4. "name": "Jack Rudenko",
  5. "email": "i@madappgang.com",
  6. "company": "MadAppGang"
  7. },
  8. "metadata": {
  9. "description": "MAG team's curated collection of Claude Code plugins for modern full-stack development with LLM performance tracking and E2E skill testing",
  10. "version": "6.2.0",
  11. "pluginRoot": "./plugins"
  12. },
  13. "plugins": [
  14. {
  15. "name": "code-analysis",
  16. "source": "./plugins/code-analysis",
  17. "description": "Deep code investigation with claudemem. v3.2.2: Updated for claudish v4.5.1 (--agent flag removed). v3.0.0: ENRICHMENT MODE.",
  18. "version": "3.2.2",
  19. "author": {
  20. "name": "Jack Rudenko",
  21. "email": "i@madappgang.com",
  22. "company": "MadAppGang"
  23. },
  24. "category": "development",
  25. "keywords": [
  26. "code-analysis",
  27. "codebase",
  28. "investigation",
  29. "detective",
  30. "architecture",
  31. "patterns",
  32. "debugging",
  33. "code-navigation",
  34. "semantic-search",
  35. "claudemem",
  36. "enrichment"
  37. ],
  38. "strict": true
  39. },
  40. {
  41. "name": "multimodel",
  42. "source": "./plugins/multimodel",
  43. "description": "Multi-model collaboration, orchestration, and workflow patterns. v2.4.1: Updated for claudish v4.5.1 (--agent flag removed). Hook logging simplified. 15 E2E tests.",
  44. "version": "2.4.1",
  45. "author": {
  46. "name": "Jack Rudenko",
  47. "email": "i@madappgang.com",
  48. "company": "MadAppGang"
  49. },
  50. "category": "development",
  51. "keywords": [
  52. "multimodel",
  53. "voting",
  54. "parallel",
  55. "consensus",
  56. "claudish",
  57. "grok",
  58. "gemini",
  59. "gpt",
  60. "orchestration",
  61. "multi-agent",
  62. "workflow",
  63. "hooks",
  64. "routing",
  65. "quality-gates"
  66. ],
  67. "strict": true
  68. },
  69. {
  70. "name": "agentdev",
  71. "source": "./plugins/agentdev",
  72. "description": "Create, implement, and review Claude Code agents and commands with multi-model validation, LLM performance tracking, and session-based artifact isolation. v1.5.2: Updated for claudish v4.5.1 (--agent flag removed).",
  73. "version": "1.5.2",
  74. "author": {
  75. "name": "Jack Rudenko",
  76. "email": "i@madappgang.com",
  77. "company": "MadAppGang"
  78. },
  79. "category": "development",
  80. "keywords": [
  81. "agents",
  82. "commands",
  83. "development",
  84. "multi-model",
  85. "claudish",
  86. "quality-review",
  87. "xml-standards",
  88. "orchestration",
  89. "debug-mode",
  90. "session-recording"
  91. ],
  92. "strict": true
  93. },
  94. {
  95. "name": "seo",
  96. "source": "./plugins/seo",
  97. "description": "Highly autonomous SEO toolkit (~80% autonomy) with AUTO GATEs, self-correction loops, and multi-model validation. v1.6.2: Updated for claudish v4.5.1 (--agent flag removed). Features E-E-A-T self-assessment, keyword research, content optimization, technical audits.",
  98. "version": "1.6.2",
  99. "author": {
  100. "name": "Jack Rudenko",
  101. "email": "i@madappgang.com",
  102. "company": "MadAppGang"
  103. },
  104. "category": "content",
  105. "keywords": [
  106. "seo",
  107. "content-optimization",
  108. "keyword-research",
  109. "serp-analysis",
  110. "technical-seo",
  111. "content-strategy",
  112. "google-analytics",
  113. "search-console",
  114. "performance-analysis"
  115. ],
  116. "strict": true
  117. },
  118. {
  119. "name": "video-editing",
  120. "source": "./plugins/video-editing",
  121. "description": "Professional video editing toolkit with FFmpeg operations, Whisper transcription, and Apple Final Cut Pro project generation. v1.1.0: Added explicit name: fields to commands for prefix-free invocation. Features intelligent video analysis, automated transcription with timing sync, FCPXML timeline creation.",
  122. "version": "1.1.0",
  123. "author": {
  124. "name": "Jack Rudenko",
  125. "email": "i@madappgang.com",
  126. "company": "MadAppGang"
  127. },
  128. "category": "media",
  129. "keywords": [
  130. "video",
  131. "ffmpeg",
  132. "transcription",
  133. "whisper",
  134. "final-cut-pro",
  135. "fcpxml",
  136. "timeline",
  137. "audio",
  138. "editing",
  139. "subtitles"
  140. ],
  141. "strict": true
  142. },
  143. {
  144. "name": "nanobanana",
  145. "source": "./plugins/nanobanana",
  146. "description": "AI image generation and editing using Google Gemini 3 Pro Image API. v2.3.0: Added explicit name: fields to commands for prefix-free invocation (/generate instead of /nanobanana:generate). Simple Node.js CLI with markdown styles and batch generation.",
  147. "version": "2.3.0",
  148. "author": {
  149. "name": "Jack Rudenko",
  150. "email": "i@madappgang.com",
  151. "company": "MadAppGang"
  152. },
  153. "category": "media",
  154. "keywords": [
  155. "image-generation",
  156. "ai-art",
  157. "gemini",
  158. "text-to-image",
  159. "image-editing",
  160. "style-transfer",
  161. "nano-banana",
  162. "google-ai"
  163. ],
  164. "strict": true
  165. },
  166. {
  167. "name": "conductor",
  168. "source": "./plugins/conductor",
  169. "description": "Context-Driven Development workflow inspired by Gemini Conductor. v2.1.0: Added explicit name: fields to commands for prefix-free invocation. Full-featured implementation with TDD workflow, Phase Completion Protocol, Git Notes audit trail, and comprehensive styleguides.",
  170. "version": "2.1.0",
  171. "author": {
  172. "name": "Jack Rudenko",
  173. "email": "i@madappgang.com",
  174. "company": "MadAppGang"
  175. },
  176. "category": "workflow",
  177. "keywords": [
  178. "conductor",
  179. "workflow",
  180. "context-driven",
  181. "tdd",
  182. "planning",
  183. "task-tracking",
  184. "git-aware",
  185. "project-management",
  186. "phase-protocol",
  187. "gemini-conductor"
  188. ],
  189. "strict": true
  190. },
  191. {
  192. "name": "dev",
  193. "source": "./plugins/dev",
  194. "description": "Universal development assistant with real skill discovery. v1.31.3: Statusline extracted to standalone plugin. 46 skills.",
  195. "version": "1.31.3",
  196. "author": {
  197. "name": "Jack Rudenko",
  198. "email": "i@madappgang.com",
  199. "company": "MadAppGang"
  200. },
  201. "category": "development",
  202. "keywords": [
  203. "development",
  204. "universal",
  205. "deep-research",
  206. "research",
  207. "convergence",
  208. "devops",
  209. "infrastructure",
  210. "kubernetes",
  211. "aws",
  212. "gcp",
  213. "azure",
  214. "firebase",
  215. "terraform",
  216. "interview",
  217. "react",
  218. "typescript",
  219. "tanstack",
  220. "tanstack-router",
  221. "tanstack-query",
  222. "golang",
  223. "dingo",
  224. "bun",
  225. "python",
  226. "rust",
  227. "ui-design",
  228. "ui-engineer",
  229. "framer-motion",
  230. "awwwards"
  231. ],
  232. "strict": true
  233. },
  234. {
  235. "name": "statusline",
  236. "source": "./plugins/statusline",
  237. "description": "Colorful statusline with worktree awareness, plan limits with reset countdowns, token counts, compaction detection, and customizable themes. v1.4.0: Session-pinned worktree marker survives context compaction.",
  238. "version": "1.4.0",
  239. "author": {
  240. "name": "Jack Rudenko",
  241. "email": "i@madappgang.com",
  242. "company": "MadAppGang"
  243. },
  244. "category": "utility",
  245. "keywords": [
  246. "statusline",
  247. "worktree",
  248. "context",
  249. "plan-limits",
  250. "customization",
  251. "themes",
  252. "reset-countdown"
  253. ],
  254. "strict": true
  255. }
  256. ]
  257. }
README.md · README · 569 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MAG Claude Plugins
  2. > **Battle-tested AI workflows from the top 1% of developers**
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  4. [![Maintained by MadAppGang](https://img.shields.io/badge/Maintained%20by-MadAppGang-blue)](https://madappgang.com)
  5. ## 🏆 Stop Wasting Time. Ship Like the Top 1%.
  6. **While you're fighting with AI prompts, elite teams are shipping 3x faster.**
  7. At [MadAppGang](https://madappgang.com) and [10xLabs](https://10xlabs.com.au), we don't do "good enough." We're the teams that Fortune 500 companies hire when their own developers can't deliver. We architect platforms processing **$50M+ in annual transactions**. We scale systems to **500,000+ concurrent users**. We ship features that make or break businesses.
  8. **Here's what separates us:** While most developers adopt new tools, we **engineer competitive advantages**.
  9. When Claude Code launched, we didn't experiment—we **weaponized it into production workflows** that have:
  10. ⚡ **Generated $2.3M in value** through faster time-to-market on enterprise contracts
  11. ⚡ **Eliminated 156+ hours per sprint** of repetitive development work
  12. ⚡ **Shipped 47 major features** to production with zero rollbacks
  13. ⚡ **Scaled to 23-person engineering teams** without losing velocity
  14. ⚡ **Cut AI token costs by 40%** while improving output quality by 60%
  15. ### The Brutal Truth About AI Development
  16. **Most developers are doing AI-assisted development wrong.**
  17. They're copying prompts from Reddit. Following tutorials from people who've never shipped to production. Using workflows that optimize for demos, not delivery.
  18. **The cost?** Weeks of wasted time. Features that ship broken. AI bills that balloon. Teams that slow down instead of speed up.
  19. ### What You Get: Production-Grade Workflows That Actually Ship
  20. Every single workflow in these plugins was **forged in the fire of real deadlines**, real users, and real revenue. Not built for GitHub stars. Built to **win contracts and crush competitors**.
  21. #### The Stack That Ships
  22. **We don't use "good enough" tools. We use the tools that win.**
  23. - 🔥 **Tailwind CSS 4 & React 19** - Latest stable releases, not outdated patterns from 2023
  24. - 🔥 **Semantic code search** - 40% token reduction = **$1,200/month saved** on AI costs for mid-size teams
  25. - 🔥 **8-phase implementation workflows** - The exact process that shipped features to **half a million users**
  26. - 🔥 **MCP-powered integrations** - Figma → Code → Browser Testing → Production in one command
  27. - 🔥 **Zero-config team synchronization** - One file. Entire team aligned. No more "works on my machine"
  28. #### What This Actually Means for You
  29. **Stop burning cash on inefficient AI usage.** Our semantic search optimization alone has saved our teams **$14,000+ annually** in API costs.
  30. **Stop shipping buggy code.** Our multi-stage review system (manual + AI + browser testing) catches 89% of bugs before they hit production.
  31. **Stop reinventing workflows.** These plugins encode **2,500+ hours** of workflow optimization that you get in 60 seconds.
  32. ### The Choice Is Simple
  33. **Option A:** Keep experimenting with generic AI prompts, watching your competitors ship faster, burning budget on trial-and-error.
  34. **Option B:** Use the exact workflows that elite teams use to **build products worth millions**.
  35. These aren't "best practices" from blog posts. This is the **battle-tested playbook** that ships features to Fortune 500 clients, scales to hundreds of thousands of users, and wins against competitors with 10x your budget.
  36. **This is how the top 1% actually builds software in 2025.**
  37. ---
  38. ## 🔄 Update to Latest Version
  39. **Already installed?** Update to get the latest features:
  40. ```bash
  41. /plugin marketplace update mag-claude-plugins
  42. ```
  43. **This single command updates everything** - works for both global and local installations. No need to reinstall plugins.
  44. ---
  45. ## 📦 Quick Start
  46. **Recommended Setup:** Add marketplace globally, enable plugins per-project.
  47. ```bash
  48. # Step 1: Add marketplace globally (one-time setup)
  49. /plugin marketplace add MadAppGang/claude-code
  50. ```
  51. Then add to your project's `.claude/settings.json`:
  52. ```json
  53. {
  54. "enabledPlugins": {
  55. "frontend@mag-claude-plugins": true,
  56. "code-analysis@mag-claude-plugins": true,
  57. "bun@mag-claude-plugins": true,
  58. "orchestration@mag-claude-plugins": true
  59. }
  60. }
  61. ```
  62. **That's it!** The plugins are now enabled for this project. Commit `.claude/settings.json` so your team gets the same setup automatically.
  63. ---
  64. ## 🎯 What's Inside
  65. This repository contains production-ready plugins designed for modern web development teams. Each plugin includes specialized agents, custom slash commands, and workflow skills to streamline your development process.
  66. ### Available Plugins
  67. #### 🎨 Frontend Development (Full-Featured)
  68. **Version:** 2.8.0 | **Category:** Development | **Model:** Sonnet | **[📖 Full Documentation](./docs/frontend.md)**
  69. Professional toolkit for TypeScript/React development with intelligent workflow detection, CSS-aware design validation, orchestrated workflows, quality automation, and team collaboration features.
  70. **Highlights:**
  71. - **NEW in v2.8.0: Intelligent Workflow Detection** - Automatically detects API/UI/Mixed tasks and adapts execution for faster, more focused implementations
  72. - **13 Specialized Agents** - Including CSS Developer, Designer ecosystem (designer + designer-codex), UI Developer team (ui-developer + ui-developer-codex), architecture planning, code review, and browser testing
  73. - **6 Slash Commands** - Including `/implement` (8-phase with adaptive workflow detection), `/implement-ui` (with task decomposition), `/validate-ui`
  74. - **3 Skills** - Browser testing, API analysis, and proactive UI implementation
  75. - **3 MCP Servers** - Apidog, Figma, Chrome DevTools (plus [Claudish CLI](https://github.com/MadAppGang/claudish) for external AI models)
  76. - **CSS-Aware Validation** - DOM inspection, computed CSS analysis, pattern awareness
  77. - **CVA Best Practices** - Comprehensive shadcn/ui integration guidance
  78. - **Task Decomposition** - Parallel execution for independent UI components
  79. **The `/implement` Workflow with Intelligent Detection:**
  80. The star feature is the `/implement` command—now with intelligent workflow detection that automatically adapts based on your task:
  81. **For API Integration Tasks** (e.g., "Integrate user management API"):
  82. - Skips design validation (PHASE 2.5) entirely
  83. - Runs 2 code reviewers (manual + AI) focused on API patterns
  84. - Skips UI testing - focuses on API service tests
  85. - **Result**: Faster implementation, no wasted time on irrelevant UI checks
  86. **For UI Implementation Tasks** (e.g., "Build UserProfile component"):
  87. 1. **Architecture Planning** → Designs solution, asks questions, gets approval
  88. 2. **Implementation** → Generates code following project patterns
  89. 2.5. **Design Fidelity Validation** → CSS-aware validation if Figma links present
  90. 3. **Triple Review** → Manual review + AI analysis + browser testing
  91. 4. **Test Generation** → UI-focused test suites
  92. 5. **User Approval** → Final review gate
  93. 6. **Cleanup** → Removes temporary artifacts
  94. 7. **Delivery** → Production-ready feature with documentation
  95. - **Result**: Pixel-perfect UI, comprehensive validation
  96. **For Mixed Tasks** (both API and UI):
  97. - Combines both workflows with appropriate focus areas
  98. - Design validation for UI parts only
  99. - All 3 reviewers with targeted focus
  100. - Both API and UI test coverage
  101. **Perfect for:** React/TypeScript teams, TanStack ecosystem, API-driven apps, Figma workflows, shadcn/ui projects, pixel-perfect UI implementation, production-ready code quality
  102. 👉 **[Read the complete guide](./docs/frontend.md)** for detailed workflow documentation
  103. ---
  104. #### 🔍 Code Analysis
  105. **Version:** 1.1.0 | **Category:** Development | **Model:** Sonnet
  106. Deep code investigation and analysis toolkit for understanding complex codebases with semantic search capabilities.
  107. **Highlights:**
  108. - **codebase-detective agent** - Investigates code patterns, relationships, and architecture
  109. - **2 Skills** - Deep analysis + semantic code search expert guidance
  110. - **MCP Integration** - Optimal usage of claude-context for 40% token reduction
  111. - **Deep analysis** - Understands code relationships across multiple files
  112. - **Pattern discovery** - Identifies usage patterns and architectural decisions
  113. - **Bug investigation** - Tracks down issues across the codebase
  114. **Perfect for:** Code exploration, bug investigation, understanding legacy code, architectural analysis, large codebase navigation
  115. ---
  116. #### ⚡ Bun Backend Development
  117. **Version:** 1.2.0 | **Category:** Development | **Model:** Sonnet
  118. Production-ready TypeScript backend development with Bun runtime, featuring comprehensive camelCase naming conventions, API documentation synchronization, and clean architecture patterns.
  119. **Highlights:**
  120. - **3 Specialized Agents** - Backend developer, API architect, Apidog synchronization specialist
  121. - **3 Slash Commands** - `/implement-api` (full-cycle), `/setup-project` (initialize), `/apidog` (sync API docs)
  122. - **1 Comprehensive Skill** - Best practices (2025) with camelCase conventions
  123. - **MCP Servers** - Apidog integration
  124. - **camelCase Conventions** - End-to-end naming consistency (database → API → frontend)
  125. - **Clean Architecture** - Layered design (routes → controllers → services → repositories)
  126. - **Apidog Integration** - Automatic API documentation synchronization with schema reuse
  127. - **Security First** - Authentication, authorization, validation, error handling built-in
  128. **The Stack:**
  129. - **Bun 1.x** - Native TypeScript execution, lightning-fast performance
  130. - **Hono 4.6** - Ultra-fast web framework, TypeScript-first
  131. - **Prisma 6.2** - Type-safe ORM with camelCase schema support
  132. - **Zod** - Runtime validation
  133. - **Biome 2.3** - Formatting + linting
  134. - **PostgreSQL/MongoDB** - Database flexibility
  135. **Perfect for:** TypeScript backend APIs, Bun projects, REST API development, microservices, API-first architectures, teams requiring naming consistency, Prisma ORM users, production-ready backends
  136. ---
  137. #### 🎯 Orchestration (Skills-Only Plugin)
  138. **Version:** 0.1.0 | **Category:** Development | **Type:** Skills Plugin
  139. Shared multi-agent coordination and workflow orchestration patterns for complex Claude Code workflows. Battle-tested patterns extracted from 100+ days of production use.
  140. **Highlights:**
  141. - **5 Comprehensive Skills** - Multi-agent coordination, multi-model validation, quality gates, TodoWrite orchestration, error recovery
  142. - **Skills-Only Architecture** - Pure knowledge plugin (no agents/commands) for context-efficient loading
  143. - **Skill Bundles** - Pre-configured combinations (core, advanced, testing, complete)
  144. - **4-Message Pattern** - Proven workflow for true parallel execution (3-5x speedup)
  145. - **Consensus Analysis** - Prioritize issues by cross-model agreement
  146. - **Battle-Tested** - 100+ days production validation, 6,774 lines of documentation
  147. - **Zero Dependencies** - Standalone, can be used by any plugin
  148. **The Skills:**
  149. 1. **multi-agent-coordination** - Parallel vs sequential execution, agent selection, sub-agent delegation
  150. 2. **multi-model-validation** - Run multiple AI models (Grok, Gemini, GPT-5) in parallel via Claudish
  151. 3. **quality-gates** - User approval gates, iteration loops, severity classification, test-driven development
  152. 4. **todowrite-orchestration** - Phase tracking for complex multi-step workflows
  153. 5. **error-recovery** - Timeout handling, API failures, partial success, graceful degradation
  154. **Usage:**
  155. ```yaml
  156. # In your agent or command frontmatter
  157. skills: orchestration:multi-model-validation, orchestration:quality-gates
  158. # Or use skill bundles
  159. skills: orchestration:complete # All 5 skills
  160. ```
  161. **Perfect for:** Plugin developers, complex multi-phase workflows, multi-model validation, parallel execution patterns, test-driven development loops, production-grade error handling
  162. 👉 **[Read the complete guide](./plugins/orchestration/README.md)** for detailed patterns and examples
  163. ---
  164. #### 🤖 Claudish - Multi-Model CLI
  165. **Repository:** [github.com/MadAppGang/claudish](https://github.com/MadAppGang/claudish) | **Category:** Development Tools | **Type:** Standalone CLI
  166. Run Claude Code with any OpenRouter model via local Anthropic API proxy. **100% VERIFIED** - Routes to real OpenRouter models, NOT Anthropic.
  167. **Top Recommended Models for Development:**
  168. - `x-ai/grok-code-fast-1` - xAI's Grok (fast coding, great for rapid prototyping)
  169. - `openai/gpt-5-codex` - OpenAI's GPT-5 Codex (advanced reasoning, complex tasks)
  170. - `minimax/minimax-m2` - MiniMax M2 (high performance, balanced)
  171. - `qwen/qwen3-vl-235b-a22b-instruct` - Alibaba's Qwen (vision-language, multimodal)
  172. - `anthropic/claude-sonnet-4.5` - Claude Sonnet (for comparison/baseline)
  173. **Features:**
  174. - 🎯 **Interactive Model Selector** - Beautiful terminal UI when no model specified
  175. - ⚡ **One-Shot Proxy** - Fresh proxy per run, random ports, parallel execution supported
  176. - 🔄 **Real-Time Streaming** - Live output from Claude Code
  177. - 🤖 **Auto-Approve by Default** - Fully autonomous (disable with `--no-auto-approve`)
  178. - 🔐 **Local Proxy Only** - All traffic through 127.0.0.1, secure by design
  179. - ✅ **100% Verified** - Comprehensive tests prove models are NOT Anthropic
  180. **Installation:**
  181. ```bash
  182. npm install -g claudish
  183. ```
  184. **Usage:**
  185. ```bash
  186. # Interactive mode - shows model selector
  187. claudish "implement user authentication"
  188. # Specific model
  189. claudish --model x-ai/grok-code-fast-1 "add tests"
  190. # Custom model ID
  191. claudish --model your/custom-model "your task"
  192. # Disable auto-approve
  193. claudish --no-auto-approve "make changes"
  194. # List all models
  195. claudish --list-models
  196. # Help
  197. claudish --help
  198. ```
  199. **Documentation:** See [github.com/MadAppGang/claudish](https://github.com/MadAppGang/claudish) for detailed setup and usage.
  200. **Perfect for:** Exploring different AI models, cost optimization, specialized tasks requiring specific model capabilities, testing model performance, avoiding Anthropic API limitations
  201. ---
  202. ## 🚀 Installation & Setup
  203. ### Prerequisites
  204. **Claude Code Requirements:**
  205. - Claude Code version with plugin system support
  206. - Plugin manifest location: `.claude-plugin/plugin.json` (required)
  207. - Settings format: `enabledPlugins` must be object with boolean values:
  208. ```json
  209. {
  210. "enabledPlugins": {
  211. "plugin-name@marketplace-name": true
  212. }
  213. }
  214. ```
  215. **System Requirements:**
  216. - Claude Code installed and configured
  217. - Git access to GitHub
  218. ### Recommended Setup: Global Marketplace + Per-Project Plugins
  219. This approach gives you the best of both worlds: marketplace installed once globally, plugins enabled individually per project.
  220. #### Step 1: Add Marketplace Globally (One-Time Setup)
  221. Each developer on your team does this once:
  222. ```bash
  223. /plugin marketplace add MadAppGang/claude-code
  224. ```
  225. This registers the MAG Claude Plugins marketplace in your Claude Code installation. You only need to do this once, and it works for all your projects.
  226. #### Step 2: Enable Plugins in Your Project
  227. Add or edit `.claude/settings.json` in your project root:
  228. ```json
  229. {
  230. "enabledPlugins": {
  231. "frontend@mag-claude-plugins": true
  232. }
  233. }
  234. ```
  235. **Commit this file to git:**
  236. ```bash
  237. git add .claude/settings.json
  238. git commit -m "Enable MAG Claude plugins for this project"
  239. git push
  240. ```
  241. #### Step 3: Team Members Get Automatic Setup
  242. When team members who have added the marketplace (Step 1) pull your project, Claude Code automatically:
  243. 1. Detects the enabled plugins
  244. 2. Installs them for this project
  245. 3. Activates them immediately
  246. **No manual installation needed!**
  247. #### Why This Approach?
  248. ✅ **One-time marketplace setup** - Add the marketplace once, use in all projects
  249. ✅ **Per-project plugin control** - Each project specifies its own plugins
  250. ✅ **Team consistency** - Everyone gets the same plugins automatically
  251. ✅ **Version controlled** - Plugin configuration committed with your code
  252. ✅ **No environment drift** - All team members have identical plugin setup
  253. ✅ **Project isolation** - Plugins only active where you need them
  254. #### Multiple Plugins
  255. Need more than one plugin? Just add more entries:
  256. ```json
  257. {
  258. "enabledPlugins": {
  259. "frontend@mag-claude-plugins": true,
  260. "code-analysis@mag-claude-plugins": true,
  261. "bun@mag-claude-plugins": true,
  262. "orchestration@mag-claude-plugins": true
  263. }
  264. }
  265. ```
  266. ---
  267. ### Verify Installation
  268. After setup, verify everything works:
  269. ```bash
  270. # Check for any errors
  271. /doctor
  272. # List installed plugins
  273. /plugin list
  274. # Should show:
  275. # frontend@mag-claude-plugins (project-specific)
  276. # Version: 1.2.0
  277. # Status: ✓ Loaded
  278. ```
  279. **Common issues:**
  280. - If `/doctor` shows errors, see [Troubleshooting](#-troubleshooting) below
  281. - If plugin not listed, ensure marketplace was added in Step 1
  282. - Plugin activates automatically when you open a project with `.claude/settings.json`
  283. ---
  284. ## 📚 Usage Guide
  285. ### Quick Start
  286. Once installed, plugins work seamlessly with Claude Code:
  287. **Agents** are automatically invoked by Claude when appropriate, or you can request them explicitly.
  288. **Slash Commands** provide powerful one-line workflows for common tasks.
  289. **Skills** enhance Claude's capabilities and are automatically used when relevant.
  290. ### Example: Full-Cycle Feature Implementation
  291. ```bash
  292. /implement Create a user profile page with avatar upload and bio editing
  293. ```
  294. This single command:
  295. 1. Plans the architecture and gets your approval
  296. 2. Implements all components following your project patterns
  297. 3. Reviews code with 3 different approaches (human + AI + browser)
  298. 4. Generates comprehensive tests
  299. 5. Cleans up artifacts
  300. 6. Delivers production-ready code with documentation
  301. **Result:** Complete feature in minutes, not hours.
  302. ### Example: Import Figma Design
  303. ```bash
  304. /import-figma NavigationBar
  305. ```
  306. Fetches your Figma component, adapts it to your codebase, installs dependencies, and opens it in browser for validation.
  307. ---
  308. **📖 For comprehensive documentation, examples, and detailed workflow explanations:**
  309. 👉 **[Frontend Development Plugin - Complete Guide](./docs/frontend.md)**
  310. The complete guide includes:
  311. - Detailed `/implement` workflow (all 7 stages explained)
  312. - Complete agent reference with use cases
  313. - All slash commands with examples
  314. - Skills documentation
  315. - MCP server setup guides
  316. - Troubleshooting and best practices
  317. ---
  318. ## 📚 Documentation
  319. ### For Users
  320. - **[Frontend Plugin Guide](./docs/frontend.md)** - Complete user guide with `/implement` workflow deep-dive
  321. - **[Troubleshooting](./docs/troubleshooting.md)** - Common issues and solutions
  322. - **[Advanced Usage](./docs/advanced-usage.md)** - Advanced configuration and workflows
  323. ### For Developers
  324. - **[Development Guide](./docs/development-guide.md)** - How to create plugins
  325. - **[Contributing Guide](./docs/contributing.md)** - How to contribute to the marketplace
  326. - **[Marketplace Reference](./docs/marketplace-reference.md)** - Technical schemas and structure
  327. - **[Version Validation](./docs/VALIDATION.md)** - Automated version validation system (prevents marketplace/plugin version mismatches)
  328. ### Technical Documentation
  329. For architecture and implementation details, see the **[ai-docs](./ai-docs/)** directory:
  330. - **[TEAM_CONFIG_ARCHITECTURE.md](./ai-docs/TEAM_CONFIG_ARCHITECTURE.md)** - Team-first configuration
  331. - **[DYNAMIC_MCP_GUIDE.md](./ai-docs/DYNAMIC_MCP_GUIDE.md)** - MCP server configuration patterns
  332. - **[COMPLETE_PLUGIN_SUMMARY.md](./ai-docs/COMPLETE_PLUGIN_SUMMARY.md)** - Complete plugin inventory
  333. - **[SEMANTIC_SEARCH_SKILL_SUMMARY.md](./ai-docs/SEMANTIC_SEARCH_SKILL_SUMMARY.md)** - Semantic search skill design
  334. ---
  335. ## 📋 Roadmap
  336. ### Current Focus
  337. - ✅ Frontend Development plugin (v2.7.0 - complete with CSS-aware validation & CVA best practices)
  338. - ✅ Code Analysis plugin (v1.1.0 - complete with semantic search)
  339. - ✅ Backend Development plugin (v1.2.0 - complete with Bun, camelCase conventions, Apidog integration)
  340. - 🚧 API Development plugin (planned)
  341. ### Future Plugins
  342. - **Testing Tools**: E2E testing, visual regression, performance testing
  343. - **UI Components**: Design system tools, component generators
  344. - **Backend Development**: Node.js, API design, database tools
  345. - **DevOps**: Docker, Kubernetes, CI/CD automation
  346. - **Documentation**: Auto-generate docs, API reference, guides
  347. ### Community Requests
  348. Have a plugin idea? [Open an issue](https://github.com/MadAppGang/claude-code/issues) with the `plugin-request` label.
  349. ---
  350. ## 📖 Detailed Documentation
  351. ### User Documentation
  352. - **[Frontend Development Plugin Guide](./docs/frontend.md)** - Complete user guide with `/implement` workflow deep-dive
  353. - **[Figma Integration Guide](./docs/figma-integration-guide.md)** - How to get Figma URLs and set up design imports
  354. ### Technical Documentation
  355. For technical details and architecture, see the **[ai-docs](./ai-docs/)** directory:
  356. #### Architecture & Configuration
  357. - **[TEAM_CONFIG_ARCHITECTURE.md](./ai-docs/TEAM_CONFIG_ARCHITECTURE.md)** - Team-first configuration, shareable config vs private secrets
  358. - **[DYNAMIC_MCP_GUIDE.md](./ai-docs/DYNAMIC_MCP_GUIDE.md)** - Dynamic MCP server configuration patterns
  359. - **[IMPROVEMENTS_SUMMARY.md](./ai-docs/IMPROVEMENTS_SUMMARY.md)** - Configuration command design decisions
  360. #### Reference
  361. - **[COMPLETE_PLUGIN_SUMMARY.md](./ai-docs/COMPLETE_PLUGIN_SUMMARY.md)** - Complete plugin inventory (13 frontend agents, 6 commands, 3 skills)
  362. - **[FINAL_SUMMARY.md](./ai-docs/FINAL_SUMMARY.md)** - Project overview and statistics
  363. #### Plugin-Specific Technical Docs
  364. - **[DEPENDENCIES.md](./plugins/frontend/DEPENDENCIES.md)** - All dependencies and environment variables
  365. - **[CONFIGURE_MCP_FLOW.md](./plugins/frontend/commands/CONFIGURE_MCP_FLOW.md)** - Configuration flow diagram
  366. ---
  367. ## 📄 License
  368. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  369. Individual plugins may have their own licenses specified in their `plugin.json` files.
  370. ---
  371. ## 👥 Maintainers
  372. **Jack Rudenko**
  373. Email: [i@madappgang.com](mailto:i@madappgang.com)
  374. Company: [MadAppGang](https://madappgang.com)
  375. ---
  376. ## 🙏 Acknowledgments
  377. - Built for [Claude Code](https://docs.claude.com/en/docs/claude-code) by Anthropic
  378. - Inspired by the amazing Claude Code community
  379. - Special thanks to all contributors
  380. ---
  381. ## 📞 Contact & Support
  382. - **Email**: [i@madappgang.com](mailto:i@madappgang.com)
  383. - **Issues**: [GitHub Issues](https://github.com/MadAppGang/claude-code/issues)
  384. - **Discussions**: [GitHub Discussions](https://github.com/MadAppGang/claude-code/discussions)
  385. - **Website**: [madappgang.com](https://madappgang.com)
  386. ---
  387. **Made with ❤️ by MadAppGang**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.