# openclaudia/openclaudia-skills architecture

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

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

## Overview

OpenClaudia is a toolkit of modular marketing skills for AI coding agents, with a CLI for installing, listing, and removing skills. The main workflow is to install selected skill directories into Claude Code, invoke a skill to perform a marketing task, and receive an output such as analysis, content, or a report. The README also documents broad SEO, content, social, email, ads, analytics, and strategy capabilities. Several skills are unsampled, so their internals and connections are not inferred; edges reflect only the CLI excerpt and explicit README descriptions.

Main entry points: [`cli/index.mjs`](https://github.com/openclaudia/openclaudia-skills/blob/main/cli/index.mjs) (OpenClaudia CLI), [`skills/podcast-edit/filler_removal.py`](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/podcast-edit/filler_removal.py) (Podcast editing), [`skills/competitor-traffic-report/scripts/fetch-traffic.js`](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/competitor-traffic-report/scripts/fetch-traffic.js) (Traffic data fetch), [`skills/gsc-portfolio-audit/scripts/audit_gsc.py`](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/gsc-portfolio-audit/scripts/audit_gsc.py) (GSC portfolio audit)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Skill Installation"]
  node_cli["OpenClaudia CLI<br/>[index.mjs]"]
  node_repo["Skills repository"]
  node_installed["Installed skills"]
end

subgraph group_seo["SEO and Research"]
  node_seo_audit["SEO audit"]
  node_keyword["Keyword research"]
  node_competitor["Competitor analysis"]
  node_gsc["GSC portfolio audit<br/>[audit_gsc.py]"]
end

subgraph group_content["Content and Messaging"]
  node_blog["Blog writing"]
  node_landing["Landing copy"]
  node_content_strategy["Content strategy"]
  node_podcast["Podcast editing<br/>[filler_removal.py]"]
  node_video_cut["Video cut filters<br/>[video_cut.py]"]
end

subgraph group_distribution["Campaign Distribution"]
  node_email["Email campaigns"]
  node_social["Social publishing"]
  node_ads["Ad campaigns"]
  node_banner["Task banner overlay<br/>[mac-overlay.js]"]
end

subgraph group_measurement["Analytics and Reporting"]
  node_traffic_fetch["Traffic data fetch<br/>[fetch-traffic.js]"]
  node_traffic_report["Traffic report builder<br/>[build-report.js]"]
  node_similarweb["SimilarWeb traffic"]
  node_analytics["Analytics skills"]
  node_report["HTML report<br/>[report.html]"]
end

node_user(("Marketing user"))
node_agent(("Claude Code agent"))
node_seo_services["SEO data services"]
node_marketing_services["Marketing platforms"]
node_transcripts["Word transcripts"]
node_ffmpeg["FFmpeg"]

node_user -->|"runs commands"| node_cli
node_cli -->|"clones skills"| node_repo
node_cli -->|"copies or removes"| node_installed
node_installed -->|"makes available"| node_agent
node_user -->|"requests marketing task"| node_agent
node_agent -->|"invokes"| node_seo_audit
node_agent -->|"invokes"| node_keyword
node_agent -->|"invokes"| node_competitor
node_agent -->|"invokes"| node_blog
node_agent -->|"invokes"| node_landing
node_agent -->|"invokes"| node_content_strategy
node_agent -->|"invokes"| node_email
node_agent -->|"invokes"| node_social
node_agent -->|"invokes"| node_ads
node_agent -->|"runs audit"| node_gsc
node_gsc -->|"queries data"| node_seo_services
node_agent -->|"runs report workflow"| node_traffic_fetch
node_traffic_fetch -->|"fetches metrics"| node_marketing_services
node_traffic_fetch -.->|"writes JSON data"| node_traffic_report
node_traffic_report -->|"builds report"| node_report
node_agent -->|"runs traffic lookup"| node_similarweb
node_similarweb -->|"fetches estimates"| node_marketing_services
node_agent -->|"uses analytics skills"| node_analytics
node_agent -->|"runs audio edit"| node_podcast
node_podcast -->|"reads transcripts"| node_transcripts
node_podcast -->|"writes audio filter"| node_video_cut
node_video_cut -->|"emits filter script"| node_ffmpeg
node_agent -->|"shows notification"| node_banner

click node_cli "https://github.com/openclaudia/openclaudia-skills/blob/main/cli/index.mjs"
click node_seo_audit "https://github.com/openclaudia/openclaudia-skills/tree/main/skills/seo-audit"
click node_keyword "https://github.com/openclaudia/openclaudia-skills/tree/main/skills/keyword-research"
click node_competitor "https://github.com/openclaudia/openclaudia-skills/tree/main/skills/competitor-analysis"
click node_gsc "https://github.com/openclaudia/openclaudia-skills/blob/main/skills/gsc-portfolio-audit/scripts/audit_gsc.py"
click node_traffic_fetch "https://github.com/openclaudia/openclaudia-skills/blob/main/skills/competitor-traffic-report/scripts/fetch-traffic.js"
click node_traffic_report "https://github.com/openclaudia/openclaudia-skills/blob/main/skills/competitor-traffic-report/scripts/build-report.js"
click node_similarweb "https://github.com/openclaudia/openclaudia-skills/blob/main/skills/similarweb-traffic/scripts/fetch-similarweb-traffic.js"
click node_analytics "https://github.com/openclaudia/openclaudia-skills/tree/main/skills"
click node_blog "https://github.com/openclaudia/openclaudia-skills/tree/main/skills/write-blog"
click node_landing "https://github.com/openclaudia/openclaudia-skills/tree/main/skills/write-landing"
click node_content_strategy "https://github.com/openclaudia/openclaudia-skills/tree/main/skills/content-strategy"
click node_email "https://github.com/openclaudia/openclaudia-skills/tree/main/skills/email-sequence"
click node_social "https://github.com/openclaudia/openclaudia-skills/tree/main/skills/social-content"
click node_ads "https://github.com/openclaudia/openclaudia-skills/tree/main/skills/google-ads"
click node_podcast "https://github.com/openclaudia/openclaudia-skills/blob/main/skills/podcast-edit/filler_removal.py"
click node_video_cut "https://github.com/openclaudia/openclaudia-skills/blob/main/skills/podcast-edit/video_cut.py"
click node_banner "https://github.com/openclaudia/openclaudia-skills/blob/main/skills/task-banner/mac-overlay.js"
click node_report "https://github.com/openclaudia/openclaudia-skills/blob/main/skills/competitor-traffic-report/templates/report.html"

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_cli,node_repo,node_installed,node_user toneBlue
class node_seo_audit,node_keyword,node_competitor,node_gsc toneAmber
class node_blog,node_landing,node_content_strategy,node_podcast,node_video_cut toneMint
class node_email,node_social,node_ads,node_banner toneRose
class node_traffic_fetch,node_traffic_report,node_similarweb,node_analytics,node_report,node_agent,node_seo_services,node_marketing_services,node_transcripts,node_ffmpeg toneIndigo
```

## Components

### Skill Installation

- [OpenClaudia CLI](https://github.com/openclaudia/openclaudia-skills/blob/main/cli/index.mjs): `cli/index.mjs`
- **Skills repository**
- **Installed skills**

### SEO and Research

- [SEO audit](https://github.com/openclaudia/openclaudia-skills/tree/main/skills/seo-audit): `skills/seo-audit`
- [Keyword research](https://github.com/openclaudia/openclaudia-skills/tree/main/skills/keyword-research): `skills/keyword-research`
- [Competitor analysis](https://github.com/openclaudia/openclaudia-skills/tree/main/skills/competitor-analysis): `skills/competitor-analysis`
- [GSC portfolio audit](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/gsc-portfolio-audit/scripts/audit_gsc.py): `skills/gsc-portfolio-audit/scripts/audit_gsc.py`

### Content and Messaging

- [Blog writing](https://github.com/openclaudia/openclaudia-skills/tree/main/skills/write-blog): `skills/write-blog`
- [Landing copy](https://github.com/openclaudia/openclaudia-skills/tree/main/skills/write-landing): `skills/write-landing`
- [Content strategy](https://github.com/openclaudia/openclaudia-skills/tree/main/skills/content-strategy): `skills/content-strategy`
- [Podcast editing](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/podcast-edit/filler_removal.py): `skills/podcast-edit/filler_removal.py`
- [Video cut filters](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/podcast-edit/video_cut.py): `skills/podcast-edit/video_cut.py`

### Campaign Distribution

- [Email campaigns](https://github.com/openclaudia/openclaudia-skills/tree/main/skills/email-sequence): `skills/email-sequence`
- [Social publishing](https://github.com/openclaudia/openclaudia-skills/tree/main/skills/social-content): `skills/social-content`
- [Ad campaigns](https://github.com/openclaudia/openclaudia-skills/tree/main/skills/google-ads): `skills/google-ads`
- [Task banner overlay](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/task-banner/mac-overlay.js): `skills/task-banner/mac-overlay.js`

### Analytics and Reporting

- [Traffic data fetch](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/competitor-traffic-report/scripts/fetch-traffic.js): `skills/competitor-traffic-report/scripts/fetch-traffic.js`
- [Traffic report builder](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/competitor-traffic-report/scripts/build-report.js): `skills/competitor-traffic-report/scripts/build-report.js`
- [SimilarWeb traffic](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/similarweb-traffic/scripts/fetch-similarweb-traffic.js): `skills/similarweb-traffic/scripts/fetch-similarweb-traffic.js`
- [Analytics skills](https://github.com/openclaudia/openclaudia-skills/tree/main/skills): `skills`
- [HTML report](https://github.com/openclaudia/openclaudia-skills/blob/main/skills/competitor-traffic-report/templates/report.html): `skills/competitor-traffic-report/templates/report.html`

### Other components

- **Marketing user**
- **Claude Code agent**
- **SEO data services**
- **Marketing platforms**
- **Word transcripts**
- **FFmpeg**

## Connections

- Marketing user → OpenClaudia CLI: runs commands (evidence: `cli/index.mjs`)
- OpenClaudia CLI → Skills repository: clones skills (evidence: `cli/index.mjs`)
- OpenClaudia CLI → Installed skills: copies or removes (evidence: `cli/index.mjs`)
- Installed skills → Claude Code agent: makes available (evidence: `README.md`)
- Marketing user → Claude Code agent: requests marketing task (evidence: `README.md`)
- Claude Code agent → SEO audit: invokes (evidence: `README.md`)
- Claude Code agent → Keyword research: invokes (evidence: `README.md`)
- Claude Code agent → Competitor analysis: invokes (evidence: `README.md`)
- Claude Code agent → Blog writing: invokes (evidence: `README.md`)
- Claude Code agent → Landing copy: invokes (evidence: `README.md`)
- Claude Code agent → Content strategy: invokes (evidence: `README.md`)
- Claude Code agent → Email campaigns: invokes (evidence: `README.md`)
- Claude Code agent → Social publishing: invokes (evidence: `README.md`)
- Claude Code agent → Ad campaigns: invokes (evidence: `README.md`)
- Claude Code agent → GSC portfolio audit: runs audit (evidence: `README.md`)
- GSC portfolio audit → SEO data services: queries data (evidence: `skills/gsc-portfolio-audit/scripts/audit_gsc.py`)
- Claude Code agent → Traffic data fetch: runs report workflow (evidence: `skills/competitor-traffic-report/scripts/fetch-traffic.js`)
- Traffic data fetch → Marketing platforms: fetches metrics (evidence: `skills/competitor-traffic-report/scripts/fetch-traffic.js`)
- Traffic data fetch → Traffic report builder: writes JSON data
- Traffic report builder → HTML report: builds report (evidence: `skills/competitor-traffic-report/scripts/build-report.js`)
- Claude Code agent → SimilarWeb traffic: runs traffic lookup (evidence: `README.md`)
- SimilarWeb traffic → Marketing platforms: fetches estimates (evidence: `skills/similarweb-traffic/scripts/fetch-similarweb-traffic.js`)
- Claude Code agent → Analytics skills: uses analytics skills (evidence: `README.md`)
- Claude Code agent → Podcast editing: runs audio edit (evidence: `skills/podcast-edit/filler_removal.py`)
- Podcast editing → Word transcripts: reads transcripts (evidence: `skills/podcast-edit/filler_removal.py`)
- Podcast editing → Video cut filters: writes audio filter (evidence: `skills/podcast-edit/filler_removal.py`)
- Video cut filters → FFmpeg: emits filter script (evidence: `skills/podcast-edit/video_cut.py`)
- Claude Code agent → Task banner overlay: shows notification (evidence: `skills/task-banner/mac-overlay.js`)