# social-media-skills/skills architecture

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

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

## Overview

Social Media Skills is a collection of Markdown instructions that equips an AI agent to handle social-media work, from brand setup through planning, content creation, publishing, and growth. The documented workflow starts with a brand profile and voice guide, proceeds through pillars and a calendar to platform-specific drafts, then validates and schedules content only after explicit approval. Separate capabilities cover media creation, platform strategy, community, and measurement. The repository provides skills rather than a conventional runtime; relationships below follow the README’s documented workflow, not inspected source calls.

Main entry points: [`skills/voice-builder/SKILL.md`](https://github.com/social-media-skills/skills/blob/main/skills/voice-builder/SKILL.md) (Voice guide), [`skills/brand-profile/SKILL.md`](https://github.com/social-media-skills/skills/blob/main/skills/brand-profile/SKILL.md) (Brand profile), [`skills/content-calendar/SKILL.md`](https://github.com/social-media-skills/skills/blob/main/skills/content-calendar/SKILL.md) (Content calendar), [`skills`](https://github.com/social-media-skills/skills/tree/main/skills) (Format writers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Brand foundation"]
  node_brand["Brand profile<br/>[SKILL.md]"]
  node_voice["Voice guide<br/>[SKILL.md]"]
  node_audience["Audience research<br/>[SKILL.md]"]
  node_strategy["Social strategy<br/>[SKILL.md]"]
end

subgraph group_planning["Strategy and planning"]
  node_pillars["Content pillars<br/>[SKILL.md]"]
  node_ideas["Idea generation"]
  node_calendar["Content calendar<br/>[SKILL.md]"]
  node_batch["Batch planning<br/>[SKILL.md]"]
  node_campaigns["Campaign planning<br/>[SKILL.md]"]
end

subgraph group_creation["Content creation"]
  node_hooks["Hook writing"]
  node_captions["Caption writing<br/>[SKILL.md]"]
  node_format_writers["Format writers"]
end

subgraph group_media_publish["Media and publishing"]
  node_video["Video creation<br/>[SKILL.md]"]
  node_image["Image prompts"]
  node_editing["Media editing<br/>[SKILL.md]"]
  node_validation["Platform validation"]
  node_scheduler["Scheduling and queue"]
end

subgraph group_growth_measure["Growth and measurement"]
  node_engagement["Engagement routine<br/>[SKILL.md]"]
  node_community["Community management<br/>[SKILL.md]"]
  node_analytics["Analytics and reporting<br/>[SKILL.md]"]
  node_experiments["A/B testing<br/>[SKILL.md]"]
end

node_user(("User"))
node_agent(("AI agent"))

node_user -->|"requests work"| node_agent
node_agent -->|"sets up"| node_brand
node_agent -->|"builds guide"| node_voice
node_brand -->|"informs"| node_voice
node_voice -->|"chains to"| node_audience
node_audience -->|"chains to"| node_strategy
node_strategy -->|"guides"| node_pillars
node_pillars -->|"chains to"| node_ideas
node_ideas -->|"chains to"| node_calendar
node_calendar -->|"chains to"| node_batch
node_batch -->|"chains to"| node_campaigns
node_brand -->|"informs"| node_format_writers
node_voice -->|"informs"| node_format_writers
node_calendar -->|"specifies drafts"| node_format_writers
node_agent -->|"routes work"| node_hooks
node_agent -->|"routes work"| node_captions
node_agent -->|"routes work"| node_video
node_agent -->|"routes work"| node_image
node_video -->|"edited in"| node_editing
node_agent -->|"validates posts"| node_validation
node_agent -->|"schedules posts"| node_scheduler
node_validation -->|"precedes"| node_scheduler
node_agent -->|"routes work"| node_engagement
node_agent -->|"routes work"| node_community
node_agent -->|"routes work"| node_analytics
node_agent -->|"routes work"| node_experiments

click node_brand "https://github.com/social-media-skills/skills/blob/main/skills/brand-profile/SKILL.md"
click node_voice "https://github.com/social-media-skills/skills/blob/main/skills/voice-builder/SKILL.md"
click node_audience "https://github.com/social-media-skills/skills/blob/main/skills/audience-research/SKILL.md"
click node_strategy "https://github.com/social-media-skills/skills/blob/main/skills/social-strategy/SKILL.md"
click node_pillars "https://github.com/social-media-skills/skills/blob/main/skills/content-pillars/SKILL.md"
click node_ideas "https://github.com/social-media-skills/skills/tree/main/skills/idea-generation-and-ideation"
click node_calendar "https://github.com/social-media-skills/skills/blob/main/skills/content-calendar/SKILL.md"
click node_batch "https://github.com/social-media-skills/skills/blob/main/skills/batch-content-plan/SKILL.md"
click node_campaigns "https://github.com/social-media-skills/skills/blob/main/skills/campaign-and-launch-planning/SKILL.md"
click node_hooks "https://github.com/social-media-skills/skills/tree/main/skills/hook-writer"
click node_captions "https://github.com/social-media-skills/skills/blob/main/skills/caption-writer/SKILL.md"
click node_format_writers "https://github.com/social-media-skills/skills/tree/main/skills"
click node_video "https://github.com/social-media-skills/skills/blob/main/skills/ai-video/SKILL.md"
click node_image "https://github.com/social-media-skills/skills/tree/main/skills/image-prompt"
click node_editing "https://github.com/social-media-skills/skills/blob/main/skills/capcut/SKILL.md"
click node_validation "https://github.com/social-media-skills/skills/tree/main/skills/platform-specs-and-validation"
click node_scheduler "https://github.com/social-media-skills/skills/tree/main/skills/scheduling-and-queue"
click node_engagement "https://github.com/social-media-skills/skills/blob/main/skills/engagement-routine/SKILL.md"
click node_community "https://github.com/social-media-skills/skills/blob/main/skills/community-management/SKILL.md"
click node_analytics "https://github.com/social-media-skills/skills/blob/main/skills/analytics-and-reporting/SKILL.md"
click node_experiments "https://github.com/social-media-skills/skills/blob/main/skills/experimentation-and-ab-testing/SKILL.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_brand,node_voice,node_audience,node_strategy,node_user toneBlue
class node_pillars,node_ideas,node_calendar,node_batch,node_campaigns toneAmber
class node_hooks,node_captions,node_format_writers toneMint
class node_video,node_image,node_editing,node_validation,node_scheduler toneRose
class node_engagement,node_community,node_analytics,node_experiments,node_agent toneIndigo
```

## Components

### Brand foundation

- [Brand profile](https://github.com/social-media-skills/skills/blob/main/skills/brand-profile/SKILL.md): `skills/brand-profile/SKILL.md`
- [Voice guide](https://github.com/social-media-skills/skills/blob/main/skills/voice-builder/SKILL.md): `skills/voice-builder/SKILL.md`
- [Audience research](https://github.com/social-media-skills/skills/blob/main/skills/audience-research/SKILL.md): `skills/audience-research/SKILL.md`
- [Social strategy](https://github.com/social-media-skills/skills/blob/main/skills/social-strategy/SKILL.md): `skills/social-strategy/SKILL.md`

### Strategy and planning

- [Content pillars](https://github.com/social-media-skills/skills/blob/main/skills/content-pillars/SKILL.md): `skills/content-pillars/SKILL.md`
- [Idea generation](https://github.com/social-media-skills/skills/tree/main/skills/idea-generation-and-ideation): `skills/idea-generation-and-ideation`
- [Content calendar](https://github.com/social-media-skills/skills/blob/main/skills/content-calendar/SKILL.md): `skills/content-calendar/SKILL.md`
- [Batch planning](https://github.com/social-media-skills/skills/blob/main/skills/batch-content-plan/SKILL.md): `skills/batch-content-plan/SKILL.md`
- [Campaign planning](https://github.com/social-media-skills/skills/blob/main/skills/campaign-and-launch-planning/SKILL.md): `skills/campaign-and-launch-planning/SKILL.md`

### Content creation

- [Hook writing](https://github.com/social-media-skills/skills/tree/main/skills/hook-writer): `skills/hook-writer`
- [Caption writing](https://github.com/social-media-skills/skills/blob/main/skills/caption-writer/SKILL.md): `skills/caption-writer/SKILL.md`
- [Format writers](https://github.com/social-media-skills/skills/tree/main/skills): `skills`

### Media and publishing

- [Video creation](https://github.com/social-media-skills/skills/blob/main/skills/ai-video/SKILL.md): `skills/ai-video/SKILL.md`
- [Image prompts](https://github.com/social-media-skills/skills/tree/main/skills/image-prompt): `skills/image-prompt`
- [Media editing](https://github.com/social-media-skills/skills/blob/main/skills/capcut/SKILL.md): `skills/capcut/SKILL.md`
- [Platform validation](https://github.com/social-media-skills/skills/tree/main/skills/platform-specs-and-validation): `skills/platform-specs-and-validation`
- [Scheduling and queue](https://github.com/social-media-skills/skills/tree/main/skills/scheduling-and-queue): `skills/scheduling-and-queue`

### Growth and measurement

- [Engagement routine](https://github.com/social-media-skills/skills/blob/main/skills/engagement-routine/SKILL.md): `skills/engagement-routine/SKILL.md`
- [Community management](https://github.com/social-media-skills/skills/blob/main/skills/community-management/SKILL.md): `skills/community-management/SKILL.md`
- [Analytics and reporting](https://github.com/social-media-skills/skills/blob/main/skills/analytics-and-reporting/SKILL.md): `skills/analytics-and-reporting/SKILL.md`
- [A/B testing](https://github.com/social-media-skills/skills/blob/main/skills/experimentation-and-ab-testing/SKILL.md): `skills/experimentation-and-ab-testing/SKILL.md`

### Other components

- **User**
- **AI agent**

## Connections

- User → AI agent: requests work (evidence: `README.md`)
- AI agent → Brand profile: sets up (evidence: `README.md`)
- AI agent → Voice guide: builds guide (evidence: `README.md`)
- Brand profile → Voice guide: informs (evidence: `README.md`)
- Voice guide → Audience research: chains to (evidence: `README.md`)
- Audience research → Social strategy: chains to (evidence: `README.md`)
- Social strategy → Content pillars: guides (evidence: `README.md`)
- Content pillars → Idea generation: chains to (evidence: `README.md`)
- Idea generation → Content calendar: chains to (evidence: `README.md`)
- Content calendar → Batch planning: chains to (evidence: `README.md`)
- Batch planning → Campaign planning: chains to (evidence: `README.md`)
- Brand profile → Format writers: informs (evidence: `README.md`)
- Voice guide → Format writers: informs (evidence: `README.md`)
- Content calendar → Format writers: specifies drafts (evidence: `README.md`)
- AI agent → Hook writing: routes work (evidence: `README.md`)
- AI agent → Caption writing: routes work (evidence: `README.md`)
- AI agent → Video creation: routes work (evidence: `README.md`)
- AI agent → Image prompts: routes work (evidence: `README.md`)
- Video creation → Media editing: edited in (evidence: `README.md`)
- AI agent → Platform validation: validates posts (evidence: `README.md`)
- AI agent → Scheduling and queue: schedules posts (evidence: `README.md`)
- Platform validation → Scheduling and queue: precedes (evidence: `README.md`)
- AI agent → Engagement routine: routes work (evidence: `README.md`)
- AI agent → Community management: routes work (evidence: `README.md`)
- AI agent → Analytics and reporting: routes work (evidence: `README.md`)
- AI agent → A/B testing: routes work (evidence: `README.md`)
