Marketplace de Skills para Agentes
DiversioTeam/agent-skills-marketplace
Padrão aberto para skills de agentes com validação e portabilidade cross-platform
Ver no GitHubRepositório central de skills reutilizáveis seguindo o padrão aberto Agent Skills, permitindo que capabilities e workflows sejam empacotados e distribuídos para múltiplos agentes (Claude, OpenAI Codex). Inclui metadados de marketplace e validação automática via CI.
Instalação
npx convez-ai DiversioTeam/agent-skills-marketplace1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Empacotar capacidades reutilizáveis em formato padronizado para agentes
- Distribuir skills via marketplaces (Claude Code, OpenAI)
- Validar qualidade e conformidade de skills automaticamente em CI/CD
- Orquestrar workflows complexos com documentação estruturada
Veredito

Infraestrutura sólida para standardizar e distribuir agent skills. Bem pensado em progressão de disclosure (metadados → SKILL.md → referências) e validação de tamanho. Ideal para equipes que querem profissionalizar a entrega de capabilities de agentes.
README
A tradução para o português deste README ainda está na fila.
agent-skills-marketplace
Agent Skills marketplace for Diversio.
🌐 Docs & tools → engineering.diversio.com
Agent Skills Standard
This repo follows the Agent Skills standard: an
open, tool-agnostic format for packaging capabilities and workflows for agents.
A skill is a directory with a required SKILL.md that contains YAML frontmatter
(name, description) and Markdown instructions, plus optional scripts/,
references/, and assets/.
Key points from the standard:
SKILL.mdis required and starts with YAML frontmatter.namemust match the skill directory and use lowercase letters, numbers, and hyphens.descriptionshould explain what the skill does and when to use it.- Optional frontmatter fields include
license,compatibility,metadata, and experimentalallowed-tools(space-delimited string). - Keep
SKILL.mdfocused; link to longer guidance inreferences/or helpers inscripts/.
Skills are designed for progressive disclosure: agents read metadata first,
load the full SKILL.md when invoked, and open references/ or scripts/
only if needed.
Compatibility (Codex + Claude Code)
To keep Skills portable across both OpenAI Codex and Claude Code:
- Prefer only
name+descriptionin YAML frontmatter; treat other fields as optional/ignored by many runtimes. - Keep
descriptionsingle-line and ≤500 chars (Codex validates this at startup). - Avoid
anthropic/claudein Skill names and don’t include XML tags inname/description(Claude). - Keep
SKILL.mdreasonably small (≈<500 lines); move deep docs intoreferences/.
SKILL.md Size Guardrail (CI-Enforced)
To keep Skills reliable and LLM-friendly, treat SKILL.md as an orchestrator, not a dump:
- Hard limit: each changed
SKILL.mdin a PR/push must stay at or below 500 lines (CI fails above this). - Keep only activation workflow, core priorities, and output contract in
SKILL.md. - Move long procedures/examples into
references/*.md. - Move reusable command logic into
scripts/. - Keep reference depth shallow (one level deep where possible) for progressive disclosure.
Run the guard locally before opening a PR:
bash scripts/validate-skills.sh
This default mode validates changed and untracked SKILL.md files in your working tree.
Use bash scripts/validate-skills.sh --all for a full-repo audit.
Working on Skills (LLM checklist)
- Start with
AGENTS.md(source of truth);CLAUDE.mdonly includes it. - Required structure:
plugins/<plugin>/skills/<skill-name>/SKILL.mdwith YAML frontmatter (name,description). - Ensure the skill directory name matches
nameand stays in kebab-case. - Add or update a corresponding
plugins/<plugin>/commands/*.mdentrypoint. - Keep
SKILL.mdfocused; put deep docs inreferences/and helpers inscripts/. - After substantive edits, do a fresh-eyes self-review of the changed skill, adjacent commands/docs, and version metadata, then fix obvious issues before stopping.
- If you change a plugin, bump its version in
plugins/<plugin>/.claude-plugin/plugin.jsonand keep.claude-plugin/marketplace.jsonin sync.
Overview
This repository hosts Diversio-maintained Agent Skills and plugin manifests so the same skills can be distributed via the Claude Code marketplace or other channels.
It also now includes the Astro website in website/, which targets
https://engineering.diversio.com. That site is the Diversio Engineering hub,
including the Agentic Tools section for marketplace plugins, individual
skills, and Pi extensions.
Documentation Philosophy
The repo-docs plugin is now explicitly informed by OpenAI's February 11,
2026 article Harness engineering: leveraging Codex in an agent-first
world.
The practical takeaway for this repo is:
- Keep
AGENTS.mdas a short routing map, not a giant handbook. - Put durable detail in focused repo-local docs.
- Treat repeated failures as harness gaps to encode in docs, wrappers, or CI.
Repository Structure
agent-skills-marketplace/
├── .claude-plugin/
│ └── marketplace.json # Marketplace definition
├── pi-packages/
│ ├── ci-status/ # Pi-native CI status extension
│ ├── dev-workflow/ # Pi-native daily developer workflow extension + skills
│ ├── image-router/ # Pi-native vision bridge for text-only models
│ ├── oh-my-pi/ # Pi-native cmux integration (notifications, split panes, workspace tabs)
│ ├── pi-timestamps/ # Pi-native subtle transcript timing rows
│ └── skills-bridge/ # Pi-native bridge to Claude Code plugin skills
├── website/ # Astro site for engineering.diversio.com
│ ├── src/pages/ # Homepage, /agentic-tools, registry, docs, /skills/*, /pi/*, /blog/*
│ ├── src/data/site-docs.ts # Build-time extraction from SKILL.md + package READMEs
│ └── public/ # Branding assets, headers, OG image
├── plugins/
│ ├── monty-code-review/ # Monty backend code review plugin
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/monty-code-review/
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ └── commands/
│ │ ├── code-review.md
│ │ └── test-hardening.md
│ ├── monolith-review-orchestrator/ # Monolith PR review orchestration plugin
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/monolith-review-orchestrator/
│ │ │ ├── SKILL.md
│ │ │ ├── references/
│ │ │ └── scripts/
│ │ └── commands/
│ │ ├── review-prs.md
│ │ ├── reassess-prs.md
│ │ └── post-review.md
│ ├── backend-atomic-commit/ # Backend pre-commit & atomic-commit plugin
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/backend-atomic-commit/SKILL.md
│ │ └── commands/
│ │ ├── pre-commit.md
│ │ ├── atomic-commit.md
│ │ └── commit.md
│ ├── backend-pr-workflow/ # Backend PR workflow plugin
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/backend-pr-workflow/SKILL.md
│ │ └── commands/check-pr.md
│ ├── bruno-api/ # Bruno API docs generator
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/bruno-api/SKILL.md
│ │ └── commands/docs.md
│ ├── code-review-digest-writer/ # Code review digest generator
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/code-review-digest-writer/SKILL.md
│ │ └── commands/review-digest.md
│ ├── plan-directory/ # Structured plan directories + RALPH loop
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/
│ │ │ ├── plan-directory/
│ │ │ │ ├── SKILL.md
│ │ │ │ └── references/ # Extended guidance
│ │ │ └── backend-ralph-plan/ # RALPH loop integration
│ │ │ ├── SKILL.md
│ │ │ ├── references/
│ │ │ └── examples/
│ │ └── commands/
│ │ ├── plan.md
│ │ ├── backend-ralph-plan.md
│ │ └── run.md # Execute RALPH plans
│ ├── pr-description-writer/ # PR description generator
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/pr-description-writer/
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ └── commands/write-pr.md
│ ├── process-code-review/ # Code review processor (fix/skip issues)
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/process-code-review/SKILL.md
│ │ └── commands/process-review.md
│ ├── mixpanel-analytics/ # MixPanel tracking implementation & review
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/mixpanel-analytics/
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ └── commands/
│ │ ├── implement.md
│ │ └── review.md
│ ├── clickup-ticket/ # ClickUp ticket management
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/clickup-ticket/
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ └── commands/
│ │ ├── configure.md
│ │ ├── create-ticket.md
│ │ ├── quick-ticket.md
│ │ ├── create-subtask.md
│ │ ├── add-to-backlog.md
│ │ ├── list-spaces.md
│ │ ├── switch-org.md
│ │ ├── add-org.md
│ │ └── refresh-cache.md
│ ├── github-ticket/ # GitHub issue management
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/github-ticket/
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ └── commands/
│ │ ├── configure.md
│ │ ├── get-issue.md
│ │ ├── list-issues.md
│ │ ├── my-issues.md
│ │ ├── create-issue.md
│ │ ├── quick-issue.md
│ │ ├── add-to-backlog.md
│ │ ├── create-linked-issue.md
│ │ └── route.md
│ ├── repo-docs/ # Repository harness docs generator
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/repo-docs-generator/
│ │ │ ├── SKILL.md
│ │ │ └── references/ # Harness principles, templates, playbooks
│ │ └── commands/
│ │ ├── generate.md
│ │ └── canonicalize.md
│ ├── visual-explainer/ # HTML visual explainers for mixed audiences
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/visual-explainer/
│ │ │ ├── SKILL.md
│ │ │ ├── references/ # Stakeholder mode, layout, diagram, and slide guidance
│ │ │ ├── scripts/ # Optional publish helpers for hosted previews
│ │ │ └── templates/ # Reference HTML templates
│ │ └── commands/explain.md
│ ├── backend-release/ # Django4Lyfe release workflow
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/release-manager/SKILL.md
│ │ └── commands/
│ │ ├── check.md
│ │ ├── create.md
│ │ └── publish.md
│ ├── dependabot-remediation/ # Unified backend/frontend Dependabot remediation
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/dependabot-remediation/
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ └── commands/
│ │ ├── backend.md
│ │ └── frontend.md
│ ├── terraform/ # Terraform/Terragrunt workflows
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/
│ │ │ ├── terraform-atomic-commit/SKILL.md
│ │ │ └── terraform-pr-workflow/SKILL.md
│ │ └── commands/
│ │ ├── pre-commit.md
│ │ ├── atomic-commit.md
│ │ └── check-pr.md
│ ├── login-cta-attribution-skill/ # CTA login attribution
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/login-cta-attribution-skill/
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ └── commands/implement.md
│ ├── frontend/ # Digest-first frontend skill (all lanes)
│ │ ├── .claude-plugin/plugin.json
│ │ ├── skills/frontend/
│ │ │ ├── SKILL.md
│ │ │ └── references/
│ │ └── commands/
│ │ ├── work.md
│ │ ├── refresh-digest.md
│ │ ├── review.md
│ │ ├── commit.md
│ │ └── new-branch.md
├── AGENTS.md # Source of truth for Claude Code behavior
├── CLAUDE.md # Sources AGENTS.md
├── README.md
├── CONTRIBUTING.md
└── LICENSE
Available Plugins
| Plugin | Description |
|---|---|
monolith-review-orchestrator | Monolith-local PR review harness for deep PR understanding, thread-aware GitHub review acquisition, deterministic worker-owned review worktrees, persistent review context, and author-guiding review output |
monty-code-review | Hyper-pedantic Django4Lyfe backend code review Skill with a built-in pytest test-hardening lane and persistent JSON-first review memory |
backend-atomic-commit | Backend pre-commit / atomic-commit Skill with iterative convergence protocol (budgets + stuck detection), enforcing AGENTS.md, pre-commit hooks (including djlint), .security helpers, and repo-local commit hygiene without AI signatures |
backend-pr-workflow | Backend PR workflow Skill that follows repo-local workflow docs, GitHub issue linkage, and migration safety checks |
bruno-api | API endpoint documentation generator from Bruno (.bru) files that traces Django4Lyfe implementations (DRF/Django Ninja) |
code-review-digest-writer | Weekly code-review digest writer Skill (repo-agnostic) |
plan-directory | Structured plan directories with PLAN.md index, numbered task files, and RALPH loop integration for iterative execution |
pr-description-writer | Generates comprehensive, reviewer-friendly PR descriptions with diagrams, structured sections, and repo-local workflow context |
process-code-review | Process code review findings - interactively fix or skip issues from monty-code-review output with status tracking |
mixpanel-analytics | MixPanel tracking implementation and review Skill for Django4Lyfe optimo_analytics module with PII protection and pattern enforcement |
clickup-ticket | Legacy ClickUp ticket management during the GitHub work-management migration |
github-ticket | GitHub-native issue management with smart defaults for monolith, backlog capture, repo-local execution routing, and project-board hydration |
repo-docs | Generate and canonicalize repository harness docs: short AGENTS.md maps, README.md, CLAUDE.md stubs, and focused repo-local docs for architecture, gates, and runbooks |
visual-explainer | Generate presentation-ready HTML explainers for plans, diffs, diagrams, audits, and stakeholder updates with interactive intake, explicit fact-vs-inference separation, and optional Netlify preview publishing |
backend-release | Django4Lyfe backend release workflow - create release PRs, date-based version bumping (YYYY.MM.DD), and GitHub release publishing |
dependabot-remediation | Unified backend/frontend Dependabot remediation workflow: .github/dependabot.yml review/scaffold, backend waves, frontend triage/execute/release, and post-merge closure verification |
terraform | Terraform/Terragrunt workflows: atomic-commit quality gates and PR workflow checks |
login-cta-attribution-skill | CTA login attribution implementation Skill for Django4Lyfe - guides adding new CTA sources, button/tab attribution, and enum registration |
frontend | Digest-first frontend skill with repo classification, dynamic detection, and internal lane routing for review, API, testing, analytics, observability, CI/CD, planning, and commit workflows |
Available Pi Packages
All six packages are installable together from one git URL (recommended) or
individually from a local checkout. The root package.json declares every
sub-package so pi can discover them from a single clone - see
Git-based install for the one-liner.
| Package | Description |
|---|---|
ci-status | Pi-native CI status extension with /ci, /ci-detail, /ci-logs, auto-watch after pushes, widget/status rendering, GitHub Actions + CircleCI support, and LLM CI tools |
dev-workflow | Pi-native daily developer workflow with 15 core workflow prompts, /workflow:help, /workflow:run, /workflow:prompts, /workflow:flow, XDG/project prompt config, CI analysis, PR review feedback, release PR prep, local skills, optional pi-subagents chain, and default cmux split launching for subagent-style workflow prompts when Pi runs inside cmux |
image-router | Pi-native image routing extension that describes screenshots and other image inputs with a vision-capable model when the active model is text-only |
oh-my-pi | Pi-native cmux integration with native cmux notifications (Waiting / Task Complete / Error), readable split pane commands (/omp-split-*) and workspace tab commands (/omp-workspace*), plus short aliases for faster typing. Low-level cmux primitives are shared via @diversio/pi-cmux. Works only inside cmux |
pi-timestamps | Pi-native subtle transcript timing rows for exact timestamps and reply-start timing, plus a playful live status line for the newest turn |
skills-bridge | Auto-discovers all 21 Claude Code plugin skills from plugins/*/skills/ and registers them as pi skills. One install bridges the gap between the plugin ecosystem and pi |
Helpful mental model:
@diversio/pi-cmux
-> shared low-level cmux primitives
-> split/workspace launch mechanics, command building, notifications
oh-my-pi
-> explicit cmux commands you can run yourself
-> /omp-split-*, /omp-workspace*
dev-workflow
-> workflow UX + seeded session/context behavior
-> automatic cmux use when the workflow clearly benefits
-> /workflow:scout, /workflow:oracle, /workflow:reviewer, /workflow:parallel
Marketplace update notifications
Pushes to main that change marketplace-delivered artifacts now post one Slack
message from this repo's own GitHub Actions workflow.
Why this exists:
- plugin updates and Pi package updates both matter to engineers
- Pi updates should not be hidden inside plugin-only notifications
- product-release Slack is the wrong layer for marketplace-local Pi changes
Mental model:
push to main
├─ changed plugins? -> Plugin items section
├─ changed pi-packages? -> Pi items section
└─ one compact Slack post in #ask-tech-team
Installation
1. Add the marketplace
From your terminal (outside Claude Code):
claude plugin marketplace add DiversioTeam/agent-skills-marketplace
Or from within a Claude Code session:
/plugin marketplace add DiversioTeam/agent-skills-marketplace
2. Install plugins
Recommended: Install at user scope (default) for compatibility with git worktrees. Project-scope plugins don't persist across worktrees.
Pi-native packages
Pi-native packages live under pi-packages/ and install with the pi CLI instead
of the Claude Code marketplace.
Git-based install (recommended)
A root package.json at the top of this repo declares every sub-package so pi
can discover ci-status, dev-workflow, image-router, oh-my-pi, pi-timestamps, and skills-bridge from one clone:
pi install git:github.com/DiversioTeam/agent-skills-marketplace
dev-workflow and oh-my-pi depend on @diversio/pi-cmux, which is
published on the public npm registry — no auth or .npmrc setup needed.
Run /reload in pi after installation. To pull the latest updates later:
pi update --extensions
Why this exists. Before this root manifest, each package needed its own
pi install "$PWD/pi-packages/<pkg>" command. Those local paths were relative to
whichever worktree you happened to be in. Two problems emerged:
- Duplicate extensions. If the same package was installed from two different
worktrees (e.g.
monolith/agent-skills-marketplaceandmonolith-for-release/agent-skills-marketplace), pi saw them as distinct packages because their resolved absolute paths differed. Both copies loaded, producing duplicate tool registrations and confusing[Extensions]output. - Fragile paths. When a worktree was deleted, pi failed to find the package at the old path. Team members on different machines or worktrees inevitably had different paths.
The git-based install solves both: one stable URL that works on any machine, any worktree, and always loads exactly one copy of each extension.
Local-path install (legacy)
If you need to install from a local checkout - for example, when testing a local change before pushing:
pi install "$PWD/pi-packages/ci-status"
pi install "$PWD/pi-packages/dev-workflow"
pi install "$PWD/pi-packages/image-router"
pi install "$PWD/pi-packages/oh-my-pi"
pi install "$PWD/pi-packages/pi-timestamps"
pi install "$PWD/pi-packages/skills-bridge"
Before local-path installs or -e smoke tests of dev-workflow or oh-my-pi,
run npm install either at the repo root or inside the target
package directory so @diversio/pi-cmux is available (public npm, no auth needed).
Plain pi install writes to global user settings. Use pi --no-extensions -e ./pi-packages/<package>
for one-off extension testing from the repo root without loading a duplicate copy
from the root marketplace manifest. Use pi install -l only when you need to
test project-local install, reload, or persistence behavior.
Install each pi package in one scope at a time. If ci-status is installed
globally and also from a different project-local path, Pi can load both copies
and duplicate get_ci_status / ci_fetch_job_logs tool registration. Remove
the duplicate project package entry from .pi/settings.json or uninstall the
global copy before reloading.
Run /reload in pi after installation. See pi-packages/ci-status/README.md,
pi-packages/dev-workflow/README.md, pi-packages/image-router/README.md,
pi-packages/oh-my-pi/README.md, and pi-packages/pi-timestamps/README.md for
command inventory, contribution workflow, and local testing commands.
Monolith Review Orchestrator
monolith-review-orchestrator is a harness-local workflow for Diversio
monolith review work. Read plugins/monolith-review-orchestrator/README.md
for prerequisites, helper commands, and usage examples.
If you already use the upstream visual-explainer plugin, uninstall it before
installing this marketplace version:
claude plugin uninstall visual-explainer@visual-explainer-marketplace
Copy-paste these commands in your terminal:
claude plugin install monolith-review-orchestrator@diversiotech
claude plugin install monty-code-review@diversiotech
claude plugin install backend-atomic-commit@diversiotech
claude plugin install backend-pr-workflow@diversiotech
claude plugin install bruno-api@diversiotech
claude plugin install code-review-digest-writer@diversiotech
claude plugin install plan-directory@diversiotech
claude plugin install pr-description-writer@diversiotech
claude plugin install process-code-review@diversiotech
claude plugin install mixpanel-analytics@diversiotech
claude plugin install clickup-ticket@diversiotech
claude plugin install github-ticket@diversiotech
claude plugin install repo-docs@diversiotech
claude plugin install visual-explainer@diversiotech
claude plugin install backend-release@diversiotech
claude plugin install dependabot-remediation@diversiotech
claude plugin install terraform@diversiotech
claude plugin install login-cta-attribution-skill@diversiotech
claude plugin install frontend@diversiotech
For project-scoped installation (shared with collaborators via .claude/settings.json):
claude plugin install monty-code-review@diversiotech --scope project
# ... repeat for each plugin
| Plugin | CLI Command |
|---|---|
| Monolith PR review orchestrator | claude plugin install monolith-review-orchestrator@diversiotech |
| Monty backend code review | claude plugin install monty-code-review@diversiotech |
| Backend pre-commit / atomic commit | claude plugin install backend-atomic-commit@diversiotech |
| Backend PR workflow | claude plugin install backend-pr-workflow@diversiotech |
| Bruno API docs generator | claude plugin install bruno-api@diversiotech |
| Code review digest writer | claude plugin install code-review-digest-writer@diversiotech |
| Plan directory + RALPH loop | claude plugin install plan-directory@diversiotech |
| PR description writer | claude plugin install pr-description-writer@diversiotech |
| Code review processor | claude plugin install process-code-review@diversiotech |
| MixPanel analytics | claude plugin install mixpanel-analytics@diversiotech |
| ClickUp ticket management | claude plugin install clickup-ticket@diversiotech |
| GitHub issue management | claude plugin install github-ticket@diversiotech |
| Repository docs generator | claude plugin install repo-docs@diversiotech |
| Visual explainer | claude plugin install visual-explainer@diversiotech |
| Backend release workflow | claude plugin install backend-release@diversiotech |
| Dependabot remediation (backend/frontend) | claude plugin install dependabot-remediation@diversiotech |
| Terraform workflows | claude plugin install terraform@diversiotech |
| Login CTA attribution | claude plugin install login-cta-attribution-skill@diversiotech |
| Frontend (all lanes) | claude plugin install frontend@diversiotech |
3. Use slash commands
Once plugins are installed:
/monolith-review-orchestrator:review-prs # Monolith-local v1 review harness for one PR or one linked cross-repo PR pair
/monolith-review-orchestrator:reassess-prs # Reload structured state and reassess after a PR or linked cross-repo PR pair changes
/monolith-review-orchestrator:post-review # Narrow v1 posting path; backend-safe path should reuse Monty machinery
/monty-code-review:code-review # Hyper-pedantic backend code review
/monty-code-review:test-hardening # Pytest-only dangerous-pattern hardening lane
/backend-atomic-commit:pre-commit # Fix backend files to meet AGENTS/pre-commit/.security standards
/backend-atomic-commit:atomic-commit # Strict atomic commit helper (all gates green, no AI signature)
/backend-atomic-commit:commit # Run all gates, fix, and create commit (full closure)
/backend-pr-workflow:check-pr # Backend PR workflow & migrations check
/bruno-api:docs # Generate endpoint docs from Bruno (.bru) files
/code-review-digest-writer:review-digest # Generate a code review digest
/plan-directory:plan # Create structured plan directory with PLAN.md
/plan-directory:backend-ralph-plan # Create RALPH loop-integrated plan for backend
/plan-directory:run <slug> # Execute a RALPH plan via ralph-wiggum loop
/pr-description-writer:write-pr # Generate a comprehensive PR description
/process-code-review:process-review # Process code review findings (fix/skip issues)
/mixpanel-analytics:implement # Implement new MixPanel tracking events
/mixpanel-analytics:review # Review MixPanel implementations for compliance
/clickup-ticket:configure # Initial setup and org configuration
/clickup-ticket:create-ticket # Full interactive ticket creation
/clickup-ticket:quick-ticket # Fast ticket with minimal prompts
/clickup-ticket:create-subtask # Add subtask to existing ticket
/clickup-ticket:add-to-backlog # Quick add to configured backlog list
/clickup-ticket:list-spaces # Browse workspace hierarchy
/clickup-ticket:switch-org # Switch between organizations
/clickup-ticket:add-org # Add a new organization
/clickup-ticket:refresh-cache # Force refresh cached data
/github-ticket:configure # Configure planning repo, execution repos, project defaults, and labels
/github-ticket:get-issue # Fetch one GitHub issue in detail
/github-ticket:list-issues # List/search issues across one repo or a small repo set
/github-ticket:my-issues # Show assigned work across configured repos
/github-ticket:create-issue # Create a full issue with canonical sections
/github-ticket:quick-issue # Create a minimal issue quickly
/github-ticket:add-to-backlog # Capture backlog work in monolith with default labels
/github-ticket:create-linked-issue # Create a linked follow-up or execution issue
/github-ticket:route # Route planning work into the right execution repo
/repo-docs:generate # Generate harness docs (AGENTS map + README + CLAUDE + focused docs)
/repo-docs:canonicalize # Audit and fix existing docs (trim AGENTS, normalize CLAUDE, add topic docs)
/visual-explainer:explain # Create a presentation-ready HTML explainer with interactive intake
/visual-explainer:explain "Auth rollout" --publish --open-url # Publish a fresh Netlify preview and open it
/backend-release:check # Check what commits are pending release
/backend-release:create # Create release PR with merge method
/backend-release:publish # Publish GitHub release after PR merge
/dependabot-remediation:backend # Backend lane: triage (includes config review/scaffold + backend scope filter) | execute-wave <N> | release
/dependabot-remediation:frontend # Frontend lane: triage (includes config review/scaffold) | execute | release
/terraform:pre-commit # Fix Terraform/Terragrunt repos to meet fmt/validate/docs standards
/terraform:atomic-commit # Strict atomic commit helper for Terraform/Terragrunt repos
/terraform:check-pr # Terraform/Terragrunt PR workflow check
/login-cta-attribution-skill:implement # Add new CTA login attribution source
/frontend:work # Main frontend entrypoint - routes to the correct lane based on arguments
/frontend:refresh-digest # Persist a full frontend project digest to docs/frontend-skill-digest/
/frontend:review # Review a frontend PR using the repo-local digest and Bumang-style priorities
/frontend:commit # Create a digest-aware atomic frontend commit with quality gates
/frontend:new-branch # Create a frontend branch using the repo's detected branch model
/omp-split-right # Recommended default: open new right-side cmux split → fresh Pi session
/omp-split-right-command <cmd> # Recommended default: open new right-side cmux split → shell command
/omp-split-down # Recommended default: open new down-side cmux split → fresh Pi session
/omp-split-down-command <cmd> # Recommended default: open new down-side cmux split → shell command
/omp-workspace [--name <title>] [prompt] # Stronger isolation: open new cmux workspace tab → fresh Pi session (focus-switching)
/omp-workspace-command [--name <title>] <cmd> # Stronger isolation: open new cmux workspace tab → shell command (focus-switching)
Monty Review Memory
monty-code-review now includes persistent JSON-first review memory.
Why this exists:
- PR review is iterative, so the reviewer often comes back after new commits.
- Re-reading every old markdown review wastes tokens and repeats old findings.
- Structured memory lets the skill load only the small amount of prior context it actually needs.
Mental model:
resolve target -> load compact memory summary -> run new review
-> write repo-local *_review.md for humans
-> persist structured memory for the next pass
Important rule:
- Structured JSON/JSONL files are the canonical memory store.
- The repo-local
*_review.mdis still the human-facing artifact and the current compatibility input forprocess-code-review. - The small v1 persistence model is just
state.jsonplusreviews.jsonlinside one deterministic scope directory.
The helper lives at:
plugins/monty-code-review/skills/monty-code-review/scripts/review_memory.py
Useful commands:
uv run --script plugins/monty-code-review/skills/monty-code-review/scripts/review_memory.py --help
uv run --script plugins/monty-code-review/skills/monty-code-review/scripts/review_memory.py \
resolve-scope \
--provider github \
--host github.com \
--owner DiversioTeam \
--repo monolith \
--pull-number 1842
uv run --script plugins/monty-code-review/skills/monty-code-review/scripts/review_memory.py \
summarize-context \
--scope-dir "<resolved-scope-dir>"
cat <<'EOF' | uv run --script plugins/monty-code-review/skills/monty-code-review/scripts/review_memory.py \
record-review \
--scope-dir "<resolved-scope-dir>"
{
"head_sha": "abc123",
"history_status": "linear",
"repo_review_file": "docs/code_reviews/pr_1842_review.md",
"recommendation": "request_changes",
"findings": {
"new": [],
"carried_forward": [],
"resolved": []
}
}
EOF
For the full protocol, schema, and maintenance rules, read:
plugins/monty-code-review/skills/monty-code-review/references/review-memory-protocol.md
Uninstall Plugins (Claude Code)
Step 1: Check what's installed
claude plugin list
Or inside Claude Code: /plugin list
Look for plugins with @diversiotech - note the Scope: field (user or project).
Step 2: Uninstall user-scoped plugins
Copy-paste these commands in your terminal:
claude plugin uninstall monolith-review-orchestrator@diversiotech
claude plugin uninstall monty-code-review@diversiotech
claude plugin uninstall backend-atomic-commit@diversiotech
claude plugin uninstall backend-pr-workflow@diversiotech
claude plugin uninstall bruno-api@diversiotech
claude plugin uninstall code-review-digest-writer@diversiotech
claude plugin uninstall plan-directory@diversiotech
claude plugin uninstall pr-description-writer@diversiotech
claude plugin uninstall process-code-review@diversiotech
claude plugin uninstall mixpanel-analytics@diversiotech
claude plugin uninstall clickup-ticket@diversiotech
claude plugin uninstall github-ticket@diversiotech
claude plugin uninstall repo-docs@diversiotech
claude plugin uninstall visual-explainer@diversiotech
claude plugin uninstall backend-release@diversiotech
claude plugin uninstall dependabot-remediation@diversiotech
claude plugin uninstall terraform@diversiotech
claude plugin uninstall login-cta-attribution-skill@diversiotech
claude plugin uninstall frontend@diversiotech
Step 3: Uninstall project-scoped plugins (if any)
If claude plugin list shows plugins at Scope: project:
claude plugin uninstall monolith-review-orchestrator@diversiotech --scope project
claude plugin uninstall monty-code-review@diversiotech --scope project
claude plugin uninstall backend-atomic-commit@diversiotech --scope project
claude plugin uninstall backend-pr-workflow@diversiotech --scope project
claude plugin uninstall bruno-api@diversiotech --scope project
claude plugin uninstall code-review-digest-writer@diversiotech --scope project
claude plugin uninstall plan-directory@diversiotech --scope project
claude plugin uninstall pr-description-writer@diversiotech --scope project
claude plugin uninstall process-code-review@diversiotech --scope project
claude plugin uninstall mixpanel-analytics@diversiotech --scope project
claude plugin uninstall clickup-ticket@diversiotech --scope project
claude plugin uninstall github-ticket@diversiotech --scope project
claude plugin uninstall repo-docs@diversiotech --scope project
claude plugin uninstall visual-explainer@diversiotech --scope project
claude plugin uninstall backend-release@diversiotech --scope project
claude plugin uninstall dependabot-remediation@diversiotech --scope project
claude plugin uninstall terraform@diversiotech --scope project
claude plugin uninstall login-cta-attribution-skill@diversiotech --scope project
claude plugin uninstall frontend@diversiotech --scope project
| Problem | Solution |
|---|---|
| Plugin shows in list but "not found" on uninstall | Try the other scope: --scope project or --scope user |
| Plugin stuck in disabled state | Enable first (claude plugin enable ...), then uninstall |
| Project-scoped plugins don't persist in git worktrees | Uninstall with --scope project, reinstall at user scope |
| Manual cleanup needed | Delete .claude/ directory in project root, or check ~/.claude/ for user config |
After uninstalling, reinstall using the install commands above.
Install As Codex Skills
Codex can install these Skills directly from GitHub (separate from Claude's marketplace) using the Skill Installer.
CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
python3 "$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
--repo DiversioTeam/agent-skills-marketplace \
--ref main \
--path \
plugins/monty-code-review/skills/monty-code-review \
plugins/monolith-review-orchestrator/skills/monolith-review-orchestrator \
plugins/backend-atomic-commit/skills/backend-atomic-commit \
plugins/backend-pr-workflow/skills/backend-pr-workflow \
plugins/bruno-api/skills/bruno-api \
plugins/code-review-digest-writer/skills/code-review-digest-writer \
plugins/plan-directory/skills/plan-directory \
plugins/plan-directory/skills/backend-ralph-plan \
plugins/pr-description-writer/skills/pr-description-writer \
plugins/process-code-review/skills/process-code-review \
plugins/mixpanel-analytics/skills/mixpanel-analytics \
plugins/clickup-ticket/skills/clickup-ticket \
plugins/github-ticket/skills/github-ticket \
plugins/repo-docs/skills/repo-docs-generator \
plugins/visual-explainer/skills/visual-explainer \
plugins/backend-release/skills/release-manager \
plugins/dependabot-remediation/skills/dependabot-remediation \
plugins/terraform/skills/terraform-atomic-commit \
plugins/terraform/skills/terraform-pr-workflow \
plugins/login-cta-attribution-skill/skills/login-cta-attribution-skill \
plugins/frontend/skills/frontend
Codex console alternative:
$skill-installer install from github repo=DiversioTeam/agent-skills-marketplace \
path=plugins/monty-code-review/skills/monty-code-review \
path=plugins/monolith-review-orchestrator/skills/monolith-review-orchestrator \
path=plugins/backend-atomic-commit/skills/backend-atomic-commit \
path=plugins/backend-pr-workflow/skills/backend-pr-workflow \
path=plugins/bruno-api/skills/bruno-api \
path=plugins/code-review-digest-writer/skills/code-review-digest-writer \
path=plugins/plan-directory/skills/plan-directory \
path=plugins/plan-directory/skills/backend-ralph-plan \
path=plugins/pr-description-writer/skills/pr-description-writer \
path=plugins/process-code-review/skills/process-code-review \
path=plugins/mixpanel-analytics/skills/mixpanel-analytics \
path=plugins/clickup-ticket/skills/clickup-ticket \
path=plugins/github-ticket/skills/github-ticket \
path=plugins/repo-docs/skills/repo-docs-generator \
path=plugins/visual-explainer/skills/visual-explainer \
path=plugins/backend-release/skills/release-manager \
path=plugins/dependabot-remediation/skills/dependabot-remediation \
path=plugins/terraform/skills/terraform-atomic-commit \
path=plugins/terraform/skills/terraform-pr-workflow \
path=plugins/login-cta-attribution-skill/skills/login-cta-attribution-skill \
path=plugins/frontend/skills/frontend
CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
python3 "$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
--repo DiversioTeam/agent-skills-marketplace \
--path plugins/monty-code-review/skills/monty-code-review
Or from the Codex console:
$skill-installer install from github repo=DiversioTeam/agent-skills-marketplace path=plugins/monty-code-review/skills/monty-code-review
CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
rm -rf "$CODEX_HOME/skills/monty-code-review" \
"$CODEX_HOME/skills/monolith-review-orchestrator" \
"$CODEX_HOME/skills/backend-atomic-commit" \
"$CODEX_HOME/skills/backend-pr-workflow" \
"$CODEX_HOME/skills/bruno-api" \
"$CODEX_HOME/skills/code-review-digest-writer" \
"$CODEX_HOME/skills/plan-directory" \
"$CODEX_HOME/skills/backend-ralph-plan" \
"$CODEX_HOME/skills/pr-description-writer" \
"$CODEX_HOME/skills/process-code-review" \
"$CODEX_HOME/skills/mixpanel-analytics" \
"$CODEX_HOME/skills/clickup-ticket" \
"$CODEX_HOME/skills/github-ticket" \
"$CODEX_HOME/skills/repo-docs-generator" \
"$CODEX_HOME/skills/visual-explainer" \
"$CODEX_HOME/skills/release-manager" \
"$CODEX_HOME/skills/dependabot-remediation" \
"$CODEX_HOME/skills/terraform-atomic-commit" \
"$CODEX_HOME/skills/terraform-pr-workflow" \
"$CODEX_HOME/skills/login-cta-attribution-skill" \
"$CODEX_HOME/skills/frontend"
echo "Done. Restart Codex and reinstall skills."
Notes:
- Add
--ref <branch-or-tag>to pin a version. - The installer does not overwrite existing Skills; delete
$CODEX_HOME/skills/<skill-name>first to update. - If you are replacing the upstream
visual-explainerskill, delete$CODEX_HOME/skills/visual-explainerfirst, then install this repo's version. - Codex installs Skills into
~/.codex/skillsby default. - Restart Codex after installing Skills.
Documentation
- Agent Skills Standard
- Agent Skills Best Practices
- Claude Agent Skills Best Practices
- OpenAI Codex Skills
- OpenAI Codex Skills (Install new skills)
- Claude Agent Skills Overview
- Claude Code Plugins
- Discover and Install Plugins
- Plugin Marketplaces
- Agent Skills
License
MIT License - see LICENSE for details.