# gooseworks-ai/goose-skills architecture

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

- Interactive diagram: https://gitdiagram.com/gooseworks-ai/goose-skills
- Repository: https://github.com/gooseworks-ai/goose-skills

## Overview

Goose Skills is a catalog of agent-executable growth workflows plus a CLI that lists, fetches, and installs skills for supported coding agents. The user journey starts with an agent request, selects and runs a skill, and can carry research into analysis and campaign creation; the README also describes learning from results. The repository includes many independently runnable capability scripts and a Meta Ads skill-optimization harness. Edges reflect README statements or shown CLI and harness references; unsampled skill implementations are represented at their enclosing directories.

Main entry points: [`bin/goose-skills.js`](https://github.com/gooseworks-ai/goose-skills/blob/main/bin/goose-skills.js) (Skills CLI), [`skills/research`](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/research) (Research), [`skills/ads`](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/ads) (Analyze), [`skillopt/envs/meta_ads_analyzer/adapter.py`](https://github.com/gooseworks-ai/goose-skills/blob/main/skillopt/envs/meta_ads_analyzer/adapter.py) (Meta Ads Adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Install CLI"]
  node_cliapp["Skills CLI<br/>[goose-skills.js]"]
  node_targets["Agent Targets<br/>[targets.js]"]
end

subgraph group_growth["Growth Workflows"]
  node_research["Research"]
  node_analysis["Analyze"]
  node_creation["Create Campaigns"]
  node_iteration["Learn And Iterate"]
end

subgraph group_specialty["Other Skill Areas"]
  node_leadgen["Lead Generation"]
  node_competitive["Competitive Intel"]
  node_monitoring["Monitoring"]
  node_social["Social Research"]
  node_seo["SEO"]
end

subgraph group_optimization["Skill Optimization"]
  node_adapter["Meta Ads Adapter<br/>[adapter.py]"]
  node_loader["Scenario Loader<br/>[dataloader.py]"]
  node_optimizer["Optimization Runner<br/>[run.py]"]
end

node_user(("User"))
node_agent(("Coding Agent"))
node_registry[("Skill Registry")]

node_user -->|"requests workflow"| node_agent
node_agent -->|"installs skills"| node_cliapp
node_cliapp -->|"fetches index and files"| node_registry
node_cliapp -->|"parses target options"| node_targets
node_agent -->|"runs research"| node_research
node_research -->|"informs analysis"| node_analysis
node_analysis -->|"guides creation"| node_creation
node_creation -->|"learns from results"| node_iteration
node_agent -->|"runs skill"| node_leadgen
node_agent -->|"runs skill"| node_competitive
node_agent -->|"runs skill"| node_monitoring
node_agent -->|"runs skill"| node_social
node_agent -->|"runs skill"| node_seo
node_optimizer -->|"uses environment"| node_adapter
node_adapter -->|"sets up loader"| node_loader

click node_cliapp "https://github.com/gooseworks-ai/goose-skills/blob/main/bin/goose-skills.js"
click node_targets "https://github.com/gooseworks-ai/goose-skills/blob/main/bin/lib/targets.js"
click node_research "https://github.com/gooseworks-ai/goose-skills/tree/main/skills/research"
click node_analysis "https://github.com/gooseworks-ai/goose-skills/tree/main/skills/ads"
click node_creation "https://github.com/gooseworks-ai/goose-skills/tree/main/skills/ads"
click node_iteration "https://github.com/gooseworks-ai/goose-skills/tree/main/skills/ads"
click node_leadgen "https://github.com/gooseworks-ai/goose-skills/tree/main/skills/lead-generation"
click node_competitive "https://github.com/gooseworks-ai/goose-skills/tree/main/skills/competitive-intel"
click node_monitoring "https://github.com/gooseworks-ai/goose-skills/tree/main/skills/monitoring"
click node_social "https://github.com/gooseworks-ai/goose-skills/tree/main/skills/social"
click node_seo "https://github.com/gooseworks-ai/goose-skills/tree/main/skills/seo"
click node_adapter "https://github.com/gooseworks-ai/goose-skills/blob/main/skillopt/envs/meta_ads_analyzer/adapter.py"
click node_loader "https://github.com/gooseworks-ai/goose-skills/blob/main/skillopt/envs/meta_ads_analyzer/dataloader.py"
click node_optimizer "https://github.com/gooseworks-ai/goose-skills/blob/main/skillopt/run.py"

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_cliapp,node_targets,node_user toneBlue
class node_research,node_analysis,node_creation,node_iteration,node_registry toneAmber
class node_leadgen,node_competitive,node_monitoring,node_social,node_seo toneMint
class node_adapter,node_loader,node_optimizer toneRose
class node_agent toneIndigo
```

## Components

### Install CLI

- [Skills CLI](https://github.com/gooseworks-ai/goose-skills/blob/main/bin/goose-skills.js): `bin/goose-skills.js`
- [Agent Targets](https://github.com/gooseworks-ai/goose-skills/blob/main/bin/lib/targets.js): `bin/lib/targets.js`

### Growth Workflows

- [Research](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/research): `skills/research`
- [Analyze](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/ads): `skills/ads`
- [Create Campaigns](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/ads): `skills/ads`
- [Learn And Iterate](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/ads): `skills/ads`

### Other Skill Areas

- [Lead Generation](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/lead-generation): `skills/lead-generation`
- [Competitive Intel](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/competitive-intel): `skills/competitive-intel`
- [Monitoring](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/monitoring): `skills/monitoring`
- [Social Research](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/social): `skills/social`
- [SEO](https://github.com/gooseworks-ai/goose-skills/tree/main/skills/seo): `skills/seo`

### Skill Optimization

- [Meta Ads Adapter](https://github.com/gooseworks-ai/goose-skills/blob/main/skillopt/envs/meta_ads_analyzer/adapter.py): `skillopt/envs/meta_ads_analyzer/adapter.py`
- [Scenario Loader](https://github.com/gooseworks-ai/goose-skills/blob/main/skillopt/envs/meta_ads_analyzer/dataloader.py): `skillopt/envs/meta_ads_analyzer/dataloader.py`
- [Optimization Runner](https://github.com/gooseworks-ai/goose-skills/blob/main/skillopt/run.py): `skillopt/run.py`

### Other components

- **User**
- **Coding Agent**
- **Skill Registry**

## Connections

- User → Coding Agent: requests workflow (evidence: `README.md`)
- Coding Agent → Skills CLI: installs skills (evidence: `README.md`)
- Skills CLI → Skill Registry: fetches index and files (evidence: `bin/goose-skills.js`)
- Skills CLI → Agent Targets: parses target options (evidence: `bin/goose-skills.js`)
- Coding Agent → Research: runs research (evidence: `README.md`)
- Research → Analyze: informs analysis (evidence: `README.md`)
- Analyze → Create Campaigns: guides creation (evidence: `README.md`)
- Create Campaigns → Learn And Iterate: learns from results (evidence: `README.md`)
- Coding Agent → Lead Generation: runs skill (evidence: `README.md`)
- Coding Agent → Competitive Intel: runs skill (evidence: `README.md`)
- Coding Agent → Monitoring: runs skill (evidence: `README.md`)
- Coding Agent → Social Research: runs skill (evidence: `README.md`)
- Coding Agent → SEO: runs skill (evidence: `README.md`)
- Optimization Runner → Meta Ads Adapter: uses environment (evidence: `skillopt/run.py`)
- Meta Ads Adapter → Scenario Loader: sets up loader (evidence: `skillopt/envs/meta_ads_analyzer/adapter.py`)
