How poteto/plugins works
This repository is a Cursor plugin marketplace: users discover standalone plugins, each providing agent skills, rules, hooks, or agents for a developer workflow. The richest runtime subsystem is Orchestrate: its CLI starts a task loop, which coordinates cloud agents, structured handoffs, model selection, and optional Slack visibility and comments. Other plugins provide review, learning, documentation, SDK guidance, and team workflows. Orchestrate links follow the excerpts and source index; plugin capabilities and marketplace membership follow the README. Unsampled plugin internals are represented by their skill entry points.
Main entry points: marketplace.json Plugin catalog · agent-manager.ts Agent manager · loop.ts Run loop · index.ts Slack adapter
Components 29
Marketplace
- Plugin catalog
.cursor-plugin/marketplace.json
Developer Workflows
- Team workflows
cursor-team-kit/skills - Thermos review
thermos/skills - Plugin scaffolding
create-plugin/skills - Agent compatibility
agent-compatibility/skills - PR review canvas
pr-review-canvas/skills/pr-review-canvas/SKILL.md - Docs canvas
docs-canvas/skills/docs-canvas/SKILL.md - Cursor SDK guidance
cursor-sdk/skills/cursor-sdk/SKILL.md - Continual learning
continual-learning/skills/continual-learning/SKILL.md - CLI design guidance
cli-for-agent/skills/cli-for-agents/SKILL.md - Learning paths
teaching/skills - Agent workflows
pstack/skills - Ralph loop
ralph-loop/skills/ralph-loop/SKILL.md
Orchestrate Runtime
- Orchestrate skill
orchestrate/skills/orchestrate/SKILL.md - Task CLI
orchestrate/skills/orchestrate/scripts/cli/task.ts - Run loop
orchestrate/skills/orchestrate/scripts/core/loop.ts - Agent manager
orchestrate/skills/orchestrate/scripts/core/agent-manager.ts - Plan and state schemas
orchestrate/skills/orchestrate/scripts/schemas.ts - Prompt rendering
orchestrate/skills/orchestrate/scripts/core/prompts.ts - Handoff handling
orchestrate/skills/orchestrate/scripts/core/handoff.ts - Failure handoffs
orchestrate/skills/orchestrate/scripts/core/failure-handoff.ts - Model selection
orchestrate/skills/orchestrate/scripts/models.ts - Task measurements
orchestrate/skills/orchestrate/scripts/measurements.ts
Orchestration Integrations
- Comment CLI
orchestrate/skills/orchestrate/scripts/cli/comments.ts - Comment retry queue
orchestrate/skills/orchestrate/scripts/core/comment-retry-queue.ts - Slack adapter
orchestrate/skills/orchestrate/scripts/adapters/index.ts - Slack client
orchestrate/skills/orchestrate/scripts/adapters/slack/client.ts
Other components
- Developer
- Slack API
Connections 28
- Developer → Plugin catalog: discovers plugins
README.md - Plugin catalog → Team workflows: lists
README.md - Plugin catalog → Thermos review: lists
README.md - Plugin catalog → Plugin scaffolding: lists
README.md - Plugin catalog → Agent compatibility: lists
README.md - Plugin catalog → PR review canvas: lists
README.md - Plugin catalog → Docs canvas: lists
README.md - Plugin catalog → Cursor SDK guidance: lists
README.md - Plugin catalog → Continual learning: lists
README.md - Plugin catalog → CLI design guidance: lists
README.md - Plugin catalog → Learning paths: lists
README.md - Plugin catalog → Agent workflows: lists
README.md - Plugin catalog → Ralph loop: lists
README.md - Plugin catalog → Orchestrate skill: lists
README.md - Developer → Task CLI: runs tasks
orchestrate/skills/orchestrate/scripts/cli/task.ts - Task CLI → Run loop: starts loop
orchestrate/skills/orchestrate/scripts/cli/task.ts - Run loop → Agent manager: coordinates agents
orchestrate/skills/orchestrate/scripts/core/loop.ts - Agent manager → Model selection: selects models
orchestrate/skills/orchestrate/scripts/core/agent-manager.ts - Agent manager → Handoff handling: parses handoffs
orchestrate/skills/orchestrate/scripts/core/agent-manager.ts - Agent manager → Failure handoffs: writes failures
orchestrate/skills/orchestrate/scripts/core/agent-manager.ts - Agent manager → Task measurements: reads measurements
orchestrate/skills/orchestrate/scripts/core/agent-manager.ts - Run loop → Plan and state schemas: uses schemas
orchestrate/skills/orchestrate/scripts/core/loop.ts - Run loop → Prompt rendering: uses prompts
- Comment CLI → Comment retry queue: posts or queues
orchestrate/skills/orchestrate/scripts/cli/comments.ts - Comment CLI → Slack adapter: creates adapter
orchestrate/skills/orchestrate/scripts/cli/comments.ts - Slack adapter → Slack client: creates client
orchestrate/skills/orchestrate/scripts/adapters/index.ts - Slack adapter → Slack API: calls API
- Agent manager → Slack adapter: mirrors status
orchestrate/skills/orchestrate/scripts/core/agent-manager.ts