# mutonby/openshorts-plugin architecture

> Architecture diagram of the GitHub repository mutonby/openshorts-plugin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mutonby/openshorts-plugin
- Repository: https://github.com/mutonby/openshorts-plugin

## Overview

OpenShorts is a Claude/Cursor plugin that guides a user through creating and managing short-form video clips via OpenShorts’ hosted MCP server. The documented flow is submit, wait, list, edit, and publish; the README also describes caption styling, clip selection and editing, and social publishing. This repository contains plugin metadata and a skill, not the processing implementation, so service internals are represented only as documented external capabilities.

Main entry points: [`skills/openshorts/SKILL.md`](https://github.com/mutonby/openshorts-plugin/blob/main/skills/openshorts/SKILL.md) (OpenShorts skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Plugin assets"]
  node_skill["OpenShorts skill<br/>[SKILL.md]"]
  node_claude_plugin["Claude manifest<br/>[plugin.json]"]
  node_cursor_plugin["Cursor manifest<br/>[plugin.json]"]
end

subgraph group_hosted["Hosted OpenShorts"]
  node_mcp["OpenShorts MCP"]
  node_clip_processing["Clip processing"]
  node_clip_management["Clip selection and editing"]
  node_caption_styling["Caption styling"]
end

subgraph group_publishing["Social publishing"]
  node_social_accounts["Connected social accounts"]
  node_publishing["Social publishing"]
end

node_user(("User"))
node_claude["Claude or Cursor"]

node_user -->|"requests clips"| node_claude
node_claude -->|"follows guidance"| node_skill
node_claude -->|"uses server"| node_mcp
node_mcp -->|"processes video"| node_clip_processing
node_mcp -->|"lists and edits"| node_clip_management
node_mcp -->|"restyles captions"| node_caption_styling
node_mcp -->|"publishes on request"| node_publishing
node_publishing -->|"posts to"| node_social_accounts

click node_skill "https://github.com/mutonby/openshorts-plugin/blob/main/skills/openshorts/SKILL.md"
click node_claude_plugin "https://github.com/mutonby/openshorts-plugin/blob/main/.claude-plugin/plugin.json"
click node_cursor_plugin "https://github.com/mutonby/openshorts-plugin/blob/main/.cursor-plugin/plugin.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_claude_plugin,node_cursor_plugin,node_user toneBlue
class node_mcp,node_clip_processing,node_clip_management,node_caption_styling toneAmber
class node_social_accounts,node_publishing toneMint
class node_claude toneIndigo
```

## Components

### Plugin assets

- [OpenShorts skill](https://github.com/mutonby/openshorts-plugin/blob/main/skills/openshorts/SKILL.md): `skills/openshorts/SKILL.md`
- [Claude manifest](https://github.com/mutonby/openshorts-plugin/blob/main/.claude-plugin/plugin.json): `.claude-plugin/plugin.json`
- [Cursor manifest](https://github.com/mutonby/openshorts-plugin/blob/main/.cursor-plugin/plugin.json): `.cursor-plugin/plugin.json`

### Hosted OpenShorts

- **OpenShorts MCP**
- **Clip processing**
- **Clip selection and editing**
- **Caption styling**

### Social publishing

- **Connected social accounts**
- **Social publishing**

### Other components

- **User**
- **Claude or Cursor**

## Connections

- User → Claude or Cursor: requests clips (evidence: `README.md`)
- Claude or Cursor → OpenShorts skill: follows guidance (evidence: `README.md`)
- Claude or Cursor → OpenShorts MCP: uses server (evidence: `README.md`)
- OpenShorts MCP → Clip processing: processes video (evidence: `README.md`)
- OpenShorts MCP → Clip selection and editing: lists and edits (evidence: `README.md`)
- OpenShorts MCP → Caption styling: restyles captions (evidence: `README.md`)
- OpenShorts MCP → Social publishing: publishes on request (evidence: `README.md`)
- Social publishing → Connected social accounts: posts to (evidence: `README.md`)
