
Backend Pr Workflow
- 3 repo stars
- Updated July 28, 2026
- DiversioTeam/agent-skills-marketplace
Run a Django backend PR through repo-local PR docs, GitHub issue linkage, and downtime-safe migrations before merge.
About
A Diversio backend PR workflow skill that walks a Django change through the team's PR process: following repo-local PR documentation, linking the GitHub issue, and applying safe, downtime-aware database migrations. A developer uses it when opening or finalizing a backend pull request to keep schema changes reversible and review-ready.
- Repo-local PR doc workflow
- GitHub issue linkage
- Downtime-safe schema migrations
- Django backend focus
Backend Pr Workflow by the numbers
- Data as of Jul 29, 2026 (Skillselion catalog sync)
/plugin marketplace add DiversioTeam/agent-skills-marketplace/plugin install backend-pr-workflow@diversiotechAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| repo stars | ★ 3 |
|---|---|
| Last updated | July 28, 2026 |
| Repository | DiversioTeam/agent-skills-marketplace ↗ |
What it does
Run a Django backend PR through repo-local PR docs, GitHub issue linkage, and downtime-safe migrations before merge.
README.md
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
Install All Plugins (CLI commands)
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
Install Individual Plugins
| 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)
Uninstall All Diversio Plugins
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
Troubleshooting
| 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.
Install All Skills (Codex)
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
Install Individual Skills (Codex)
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
Uninstall All Skills (Codex)
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.