{"id":49427548,"url":"https://github.com/produtoramaxvision/claude-code-maxvision-orchestration","last_synced_at":"2026-05-04T13:01:27.818Z","repository":{"id":354531252,"uuid":"1224036374","full_name":"produtoramaxvision/claude-code-maxvision-orchestration","owner":"produtoramaxvision","description":"Dynamic skill+subagent orchestrator for Claude Code: reads CLAUDE-agents.md, audits local components, checks upstream versions, and proposes installs/updates from a curated catalog before dispatching the task.","archived":false,"fork":false,"pushed_at":"2026-04-28T23:20:41.000Z","size":62,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T01:17:15.665Z","etag":null,"topics":["claude-code","claude-plugin","claude-skills","orchestration","plugin-marketplace","skill-router","subagents","version-check"],"latest_commit_sha":null,"homepage":"https://github.com/produtoramaxvision/claude-code-maxvision-orchestration","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/produtoramaxvision.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-28T22:39:49.000Z","updated_at":"2026-04-28T23:20:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/produtoramaxvision/claude-code-maxvision-orchestration","commit_stats":null,"previous_names":["produtoramaxvision/claude-code-maxvision-orchestration"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/produtoramaxvision/claude-code-maxvision-orchestration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/produtoramaxvision%2Fclaude-code-maxvision-orchestration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/produtoramaxvision%2Fclaude-code-maxvision-orchestration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/produtoramaxvision%2Fclaude-code-maxvision-orchestration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/produtoramaxvision%2Fclaude-code-maxvision-orchestration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/produtoramaxvision","download_url":"https://codeload.github.com/produtoramaxvision/claude-code-maxvision-orchestration/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/produtoramaxvision%2Fclaude-code-maxvision-orchestration/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32608309,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"ssl_error","status_checked_at":"2026-05-04T10:08:02.005Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","claude-plugin","claude-skills","orchestration","plugin-marketplace","skill-router","subagents","version-check"],"created_at":"2026-04-29T10:07:39.404Z","updated_at":"2026-05-04T13:01:27.812Z","avatar_url":"https://github.com/produtoramaxvision.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e **Read in:** 🇺🇸 [English](README.md) | 🇧🇷 [Português (Brasil)](README.pt-BR.md)\n\n# Claude Code MaxVision Orchestration\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)\n\n\u003e Dynamic skill + subagent orchestrator for Claude Code. Reads `CLAUDE-agents.md`, audits what is installed locally, checks upstream versions, and proposes installs/updates from a curated catalog before dispatching the task.\n\nWhen you fire a complex task at Claude Code, this plugin makes sure the **right subagent** runs with the **right skills**, and that those skills are **fresh** — pulling missing pieces from a curated catalog of premium sources (Anthropic official, VoltAgent, Antigravity, Composio, Obra, Trail of Bits, shadcn, and more) only after explicit human approval.\n\n---\n\n## What it does\n\nGiven a task, the orchestrator:\n\n1. Reads `~/.claude/CLAUDE-agents.md` and `~/.claude/CLAUDE-skills.md` (your global cheatsheets).\n2. Inventories every skill and subagent currently installed (personal + plugin + project scopes).\n3. Picks the best subagent and required skills for the task.\n4. **Checks upstream versions** of every component it will use (1-hour cache, `--force-check` to bypass).\n5. Identifies missing components and looks them up in a curated catalog (`skills/discover-skill/references/skill-sources.json`).\n6. Presents **one consolidated plan** — updates + installs — and waits for `sim/all/skip-N/none`.\n7. Executes approved actions in order (updates first, installs second), tracking origin in `.maxv-source.json` per skill.\n8. Dispatches the subagent with the right skills loaded.\n\nNothing destructive runs without explicit user approval.\n\n## Installation\n\n### Option 1: via Marketplace (recommended)\n\n```text\n/plugin marketplace add produtoramaxvision/claude-code-maxvision-orchestration\n/plugin install maxvision-orchestration@maxvision-orchestration\n```\n\n### Option 2: local dev (without installing)\n\n```bash\ngit clone https://github.com/produtoramaxvision/claude-code-maxvision-orchestration.git\nclaude --plugin-dir ./claude-code-maxvision-orchestration\n```\n\n## Quick start\n\nAfter installation, in any Claude Code session:\n\n```text\n/maxvision-orchestration:orchestrate refactor src/components/Foo.tsx to use shadcn Select and add tests\n```\n\nThe plugin will:\n- Identify that this needs `react-specialist` + `test-automator` subagents and `frontend-design` + `shadcn/ui` + `superpowers:test-driven-development` skills.\n- Notice `shadcn/ui` is missing and `frontend-design` has a newer upstream sha.\n- Show you a single approval prompt.\n- After your `sim`, install/update and dispatch.\n\n## Skills exposed by this plugin\n\n| Skill | Purpose |\n| --- | --- |\n| `orchestrate` | Master entry point. Runs the 8-step orchestration. |\n| `route-task` | Reads `CLAUDE-agents.md`/`CLAUDE-skills.md` and picks subagent + skills. |\n| `discover-skill` | Looks up a component name/keyword against the curated catalog. |\n| `check-version` | Compares local `gitCommitSha`/`commit_sha` with upstream. Cache-aware. |\n| `update-component` | Applies an upstream update to a skill or agent (with confirmation). |\n| `install-skill` | Installs a skill via one of three methods (sparse-clone, marketplace, npx antigravity). |\n| `audit-local-skills` | Inventory + redundancy + budget report. |\n| `refresh-catalog` | Re-fetches upstream metadata to refresh `skill-sources.json`. |\n\n## Custom subagent\n\n| Agent | Purpose |\n| --- | --- |\n| `orchestrator` | Coordinates the multi-step flow above. Permissioned for read + bash + Agent. |\n\n## Catalog of sources\n\nDocumented in [docs/CATALOG-SOURCES.md](docs/CATALOG-SOURCES.md). 4 trust tiers:\n\n- **Tier 1 (Official Anthropic):** `anthropics/skills`.\n- **Tier 2 (Curated premium):** `VoltAgent/awesome-agent-skills`, `sickn33/antigravity-awesome-skills`, `obra/superpowers-skills`, `obra/superpowers-lab`, `ComposioHQ/awesome-claude-skills`, `jeremylongshore/claude-code-plugins-plus-skills`.\n- **Tier 3 (Domain-specific):** `trailofbits/skills`, `expo/skills`, `shadcn/ui`, `lackeyjb/playwright-skill`, `chrisvoncsefalvay/claude-d3js-skill`, `K-Dense-AI/claude-scientific-skills`.\n- **Tier 4 (Evaluate with caution):** `alirezarezvani/claude-skills` (high overlap with `knowledge-work-plugins`).\n\n## Architecture\n\nSee [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for the 8-phase flow diagram, cache layout (`~/.claude/cache/maxv-orchestration/version-check.json`), and `.maxv-source.json` schema.\n\n## Adding a new source to the catalog\n\nSee [docs/EXTENDING.md](docs/EXTENDING.md).\n\n## CLI helper\n\nThe plugin ships a bash CLI at `bin/maxv-skills`, automatically added to PATH while the plugin is enabled. Use it outside Claude Code sessions:\n\n```bash\nmaxv-skills list                    # list all local skills\nmaxv-skills find \u003ckeyword\u003e          # search catalog + local\nmaxv-skills check \u003ccomponent\u003e       # version check (uses cache)\nmaxv-skills check --force \u003ccomp\u003e    # bypass cache, re-fetch upstream\nmaxv-skills install \u003cskill-id\u003e      # interactive install with confirmation\nmaxv-skills update \u003ccomponent\u003e      # interactive update\nmaxv-skills audit                   # redundancy + budget report\n```\n\n## Requirements\n\n- Claude Code ≥ 2.0\n- `gh` CLI authenticated (`gh auth status`) — used by `check-version`\n- `jq` available in PATH — used by version comparison\n- `npx` (Node ≥ 18) — only required for the antigravity install path\n\n## Hard rules (guardrails)\n\n- Never installs or updates silently. Single approval prompt with `sim/all/skip-N/none`.\n- Never dispatches to `general-purpose` Agent (denied by user policy).\n- Max 3-4 subagents in parallel.\n- Updates run before installs (updates can change resolution of new installs).\n- Persists install method and origin in `.maxv-source.json` per skill folder for repeatable updates.\n\n## Attribution\n\nThis plugin orchestrates third-party skill collections under their respective licenses (MIT/Apache-2.0). See [NOTICE](NOTICE) for full attribution and [LICENSE](LICENSE) for plugin-level terms.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). PRs welcome for:\n- New entries in `skill-sources.json` (source verification required)\n- Improvements to the version-check strategy for non-git sources\n- Bug fixes in the install methods\n\n## Security\n\nReport vulnerabilities privately via the process in [SECURITY.md](SECURITY.md). Do not open public issues for security concerns.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n© 2026 Produtora MaxVision\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprodutoramaxvision%2Fclaude-code-maxvision-orchestration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprodutoramaxvision%2Fclaude-code-maxvision-orchestration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprodutoramaxvision%2Fclaude-code-maxvision-orchestration/lists"}