Agent Plugins

A collection of plugins for AI coding agents including Claude Code, Codex, and other agentic development tools.

Plugin Catalog

Plugins are grouped by what they do. Type is how each one is built: Command (slash command), Agent, Skill, Hook (shell event hook), or Hook module (TypeScript function hooks running inside Claude Code 2.1.289+, a.k.a. a "mod").

Review & thinking

Git, docs & notes

Session & input automation

Getting Started

Claude Code

# Add this marketplace to Claude Code
/plugin marketplace add shdennlin/agent-plugins

# Install a plugin
/plugin install reviewer@shdennlin-plugins

# List available plugins
/plugin list shdennlin-plugins

# Update a plugin
/plugin update reviewer@shdennlin-plugins

# Remove a plugin
/plugin uninstall reviewer@shdennlin-plugins

Codex

Tell Codex to fetch and follow the install instructions for the plugin you want:

Restart Codex after installation to discover the skills.

Update: cd ~/.codex/shdennlin-agent-plugins && git pull — skills update instantly through the symlink.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Adding a New Plugin

1. Create a new directory under plugins/
2. Follow the standard plugin structure:

   plugins/your-plugin/
   ├── .claude-plugin/
   │   └── plugin.json
   ├── .codex/
   │   └── INSTALL.md   # (optional) - Codex installation guide
   ├── commands/        # (optional) - slash commands
   ├── agents/          # (optional) - proactive agents
   ├── hooks/           # (optional) - event hooks
   ├── skills/          # (optional) - auto-discovery skills
   └── README.md
   

3. Add your plugin to .claude-plugin/marketplace.json
4. Update this README's plugin catalog
5. Submit a pull request

License

MIT License - see LICENSE for details.

Author

shdennlin - GitHub

Resources

• Claude Code Documentation
• Plugin Development Guide
• Marketplace Documentation

{
  "name": "shdennlin-plugins",
  "owner": {
    "name": "shdennlin",
    "email": "shawndennislin@gmail.com"
  },
  "plugins": [
    {
      "name": "mermaid-validator",
      "source": "./plugins/mermaid-validator",
      "description": "Validates and fixes Mermaid diagram syntax in Markdown files with skill and agent",
      "version": "2.1.1",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "mermaid",
        "validation",
        "diagrams",
        "markdown",
        "fix",
        "agent",
        "skill"
      ],
      "category": "validation"
    },
    {
      "name": "git-workflow",
      "source": "./plugins/git-workflow",
      "description": "Git workflow automation commands with Conventional Commits support",
      "version": "1.2.1",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "git",
        "merge",
        "commit",
        "status",
        "sync",
        "submodules",
        "workflow",
        "conventional-commits"
      ],
      "category": "workflow"
    },
    {
      "name": "reviewer",
      "source": "./plugins/reviewer",
      "description": "Structured spec and implementation review. Spec command runs multi-angle parallel review by default; opt into iterative fix loop with --fix. Dual-engine (Claude + Codex) spec review via /reviewer:spec-dual.",
      "version": "1.9.0",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "review",
        "spec",
        "code-review",
        "handoff",
        "agent-loop",
        "openspec",
        "spectra",
        "init",
        "iterative-fix",
        "parallel-review",
        "orchestrator",
        "code-explorer",
        "dual-engine",
        "codex",
        "workflow"
      ],
      "category": "review"
    },
    {
      "name": "digest",
      "source": "./plugins/digest",
      "description": "Summarize AI-generated branches, PRs, and diffs into icon-rich cards, explain code state with git archaeology as self-contained HTML explainers, plus multi-project weekly recall digests",
      "version": "2.0.0",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "digest",
        "summary",
        "explain",
        "changelog",
        "diff",
        "PR",
        "weekly",
        "recall",
        "git-log",
        "html"
      ],
      "category": "analysis"
    },
    {
      "name": "ralph-loop",
      "source": "./plugins/ralph-loop",
      "description": "Continuous self-referential AI loops for iterative development with session isolation fix",
      "version": "1.0.3",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "ralph-loop",
        "loop",
        "iteration",
        "self-referential",
        "session-isolation"
      ],
      "category": "workflow"
    },
    {
      "name": "project-notes",
      "source": "./plugins/project-notes",
      "description": "Capture project sessions to a structured journal using a 6-field daily template, then harvest ⭐ items into permanent-note drafts grouped by theme",
      "version": "0.3.0",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "journal",
        "logging",
        "notes",
        "obsidian",
        "zettelkasten",
        "reflection",
        "session-log",
        "learning-log",
        "harvest",
        "distillation"
      ],
      "category": "workflow"
    },
    {
      "name": "discuss",
      "source": "./plugins/discuss",
      "description": "Portable framing discussions — size the decision, then list assumptions, rank hypotheses, or interview, converging on an explicit decision. No external CLI dependency.",
      "version": "0.3.0",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "framing",
        "design",
        "discussion",
        "decision",
        "convergence",
        "brainstorming",
        "hypotheses"
      ],
      "category": "workflow"
    },
    {
      "name": "prompt-builder",
      "source": "./plugins/prompt-builder",
      "description": "Build paste-ready prompts from messy context — extract intent from the conversation, decompose multi-task requests, fill component gaps, and emit a self-contained prompt that survives a rewind.",
      "version": "0.2.0",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "prompt",
        "prompt-engineering",
        "rewind",
        "context",
        "decomposition",
        "clipboard"
      ],
      "category": "workflow"
    },
    {
      "name": "cache-keepalive",
      "source": "./plugins/cache-keepalive",
      "description": "Keeps the main thread's prompt cache warm while you are idle: one cheap fork ping just before the TTL runs out, capped, verified on every hit.",
      "version": "0.3.2",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "prompt-cache",
        "keepalive",
        "ttl",
        "mod",
        "statusline"
      ],
      "category": "workflow"
    },
    {
      "name": "cut-input",
      "source": "./plugins/cut-input",
      "description": "Copy the prompt box to the clipboard and clear it: Ctrl+Shift+U cuts the whole draft, and a Cut button shows while the box has text.",
      "version": "0.2.0",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "clipboard",
        "prompt",
        "input",
        "mod"
      ],
      "category": "workflow"
    },
    {
      "name": "image-peek",
      "source": "./plugins/image-peek",
      "description": "Thumbnails of the images you paste, above the prompt; click the magnifier to enlarge one in a pane.",
      "version": "0.1.1",
      "author": {
        "name": "shdennlin"
      },
      "homepage": "https://github.com/shdennlin/agent-plugins",
      "repository": "https://github.com/shdennlin/agent-plugins",
      "license": "MIT",
      "keywords": [
        "image",
        "paste",
        "preview",
        "thumbnail",
        "mod"
      ],
      "category": "workflow"
    }
  ]
}