# terminalskills/skills architecture

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

- Interactive diagram: https://gitdiagram.com/terminalskills/skills
- Repository: https://github.com/terminalskills/skills

## Overview

Terminal Skills is a content library of Agent Skills, with Claude Code plugins that expose catalog routing and a separate SEOG MCP integration. The principal workflow is an agent or developer selecting a skill, reading its instructions and references, then carrying out the described task with its available tools. The graph groups the broad catalog by capability rather than implying a single processing pipeline. README documents plugin tools and SEOG features; sampled source does not establish wiring for most catalog entries.

Main entry points: [`skills`](https://github.com/terminalskills/skills/tree/main/skills) (Skill Collection), [`claude-plugin`](https://github.com/terminalskills/skills/tree/main/claude-plugin) (Terminal Skills Plugin), [`claude-plugin/skills/skill-planner/SKILL.md`](https://github.com/terminalskills/skills/blob/main/claude-plugin/skills/skill-planner/SKILL.md) (Skill Planner), [`plugins/seog`](https://github.com/terminalskills/skills/tree/main/plugins/seog) (SEOG Plugin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Skill Catalog"]
  node_catalog["Skill Collection"]
  node_engineering["Development Skills"]
  node_data["Data Skills"]
  node_business["Business Skills"]
  node_creative["Creative Skills"]
  node_skill_instructions["Skill Instructions"]
end

subgraph group_workflow["Skill Routing"]
  node_plugin["Terminal Skills Plugin"]
  node_planner["Skill Planner<br/>[SKILL.md]"]
end

subgraph group_seo["Local SEO"]
  node_seog_plugin["SEOG Plugin"]
  node_seog_skill["SEOG Instructions<br/>[SKILL.md]"]
  node_seog_tools["SEOG MCP Tools<br/>[mcp-tools.md]"]
end

node_agent(("AI Agent"))
node_developer(("Developer"))
node_seog_service["SEOG Service"]
node_task_tools["Task Tools"]

node_developer -->|"browses"| node_catalog
node_agent -->|"uses"| node_plugin
node_plugin -->|"provides"| node_planner
node_planner -->|"routes across"| node_catalog
node_agent -->|"selects"| node_catalog
node_catalog -->|"contains"| node_skill_instructions
node_skill_instructions -->|"guides use of"| node_task_tools
node_agent -->|"installs"| node_seog_plugin
node_seog_plugin -->|"bundles"| node_seog_skill
node_seog_skill -->|"describes"| node_seog_tools
node_agent -.->|"requests"| node_seog_service
node_seog_service -.->|"supports"| node_task_tools

click node_catalog "https://github.com/terminalskills/skills/tree/main/skills"
click node_engineering "https://github.com/terminalskills/skills/tree/main/skills/code-reviewer"
click node_data "https://github.com/terminalskills/skills/tree/main/skills/pdf-analyzer"
click node_business "https://github.com/terminalskills/skills/tree/main/skills/seog"
click node_creative "https://github.com/terminalskills/skills/tree/main/skills/frontend-design"
click node_skill_instructions "https://github.com/terminalskills/skills/tree/main/skills"
click node_plugin "https://github.com/terminalskills/skills/tree/main/claude-plugin"
click node_planner "https://github.com/terminalskills/skills/blob/main/claude-plugin/skills/skill-planner/SKILL.md"
click node_seog_plugin "https://github.com/terminalskills/skills/tree/main/plugins/seog"
click node_seog_skill "https://github.com/terminalskills/skills/blob/main/plugins/seog/skills/seog/SKILL.md"
click node_seog_tools "https://github.com/terminalskills/skills/blob/main/plugins/seog/skills/seog/references/mcp-tools.md"

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_catalog,node_engineering,node_data,node_business,node_creative,node_skill_instructions toneBlue
class node_plugin,node_planner toneAmber
class node_seog_plugin,node_seog_skill,node_seog_tools toneMint
class node_agent,node_developer,node_seog_service toneIndigo
class node_task_tools toneRose
```

## Components

### Skill Catalog

- [Skill Collection](https://github.com/terminalskills/skills/tree/main/skills): `skills`
- [Development Skills](https://github.com/terminalskills/skills/tree/main/skills/code-reviewer): `skills/code-reviewer`
- [Data Skills](https://github.com/terminalskills/skills/tree/main/skills/pdf-analyzer): `skills/pdf-analyzer`
- [Business Skills](https://github.com/terminalskills/skills/tree/main/skills/seog): `skills/seog`
- [Creative Skills](https://github.com/terminalskills/skills/tree/main/skills/frontend-design): `skills/frontend-design`
- [Skill Instructions](https://github.com/terminalskills/skills/tree/main/skills): `skills`

### Skill Routing

- [Terminal Skills Plugin](https://github.com/terminalskills/skills/tree/main/claude-plugin): `claude-plugin`
- [Skill Planner](https://github.com/terminalskills/skills/blob/main/claude-plugin/skills/skill-planner/SKILL.md): `claude-plugin/skills/skill-planner/SKILL.md`

### Local SEO

- [SEOG Plugin](https://github.com/terminalskills/skills/tree/main/plugins/seog): `plugins/seog`
- [SEOG Instructions](https://github.com/terminalskills/skills/blob/main/plugins/seog/skills/seog/SKILL.md): `plugins/seog/skills/seog/SKILL.md`
- [SEOG MCP Tools](https://github.com/terminalskills/skills/blob/main/plugins/seog/skills/seog/references/mcp-tools.md): `plugins/seog/skills/seog/references/mcp-tools.md`

### Other components

- **AI Agent**
- **Developer**
- **SEOG Service**
- **Task Tools**

## Connections

- Developer → Skill Collection: browses
- AI Agent → Terminal Skills Plugin: uses
- Terminal Skills Plugin → Skill Planner: provides
- Skill Planner → Skill Collection: routes across
- AI Agent → Skill Collection: selects
- Skill Collection → Skill Instructions: contains
- Skill Instructions → Task Tools: guides use of
- AI Agent → SEOG Plugin: installs
- SEOG Plugin → SEOG Instructions: bundles
- SEOG Instructions → SEOG MCP Tools: describes
- AI Agent → SEOG Service: requests
- SEOG Service → Task Tools: supports