# composio-community/awesome-codex-skills architecture

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

- Interactive diagram: https://gitdiagram.com/composio-community/awesome-codex-skills
- Repository: https://github.com/composio-community/awesome-codex-skills

## Overview

This repository is a curated collection of Codex skills and small utilities, rather than one application. The main user workflow is to select a skill, install it into Codex, and let Codex match its metadata to a task before loading its instructions. Other meaningful branches include MCP-server building and evaluation, skill authoring, GitHub helpers, and a Slack GIF generator. The README documents the install-and-trigger flow; source-index references support the shown module calls. Several listed skills have no sampled implementation, so their internal behavior is not expanded.

Main entry points: [`slack-gif-creator/templates`](https://github.com/composio-community/awesome-codex-skills/tree/master/slack-gif-creator/templates) (Animation templates), [`skill-installer/scripts/install-skill-from-github.py`](https://github.com/composio-community/awesome-codex-skills/blob/master/skill-installer/scripts/install-skill-from-github.py) (Skill installer), [`composio-skills`](https://github.com/composio-community/awesome-codex-skills/tree/master/composio-skills) (Skill bundles), [`slack-gif-creator/core/gif_builder.py`](https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/gif_builder.py) (GIF builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Skill catalog"]
  node_skill_bundle["Skill bundles"]
  node_installer["Skill installer"]
  node_github_utils["GitHub fetch helpers<br/>[github_utils.py]"]
  node_skill_metadata["Skill metadata"]
  node_skill_guidance["Skill guidance"]
  node_curated_listing["Curated listing"]
end

subgraph group_authoring["Skill authoring"]
  node_author_init["Initialize skill<br/>[init_skill.py]"]
  node_author_validate["Validate skill<br/>[quick_validate.py]"]
  node_author_package["Package skill<br/>[package_skill.py]"]
end

subgraph group_mcp["MCP tools"]
  node_mcp_connections["MCP connections<br/>[connections.py]"]
  node_mcp_evaluation["MCP evaluation<br/>[evaluation.py]"]
end

subgraph group_helpers["Workflow helpers"]
  node_pr_comments["PR comments<br/>[fetch_comments.py]"]
  node_ci_inspection["CI inspection"]
end

subgraph group_gif["GIF generation"]
  node_gif_templates["Animation templates"]
  node_gif_builder["GIF builder<br/>[gif_builder.py]"]
  node_frame_composer["Frame composition<br/>[frame_composer.py]"]
  node_easing["Motion easing<br/>[easing.py]"]
  node_typography["Typography<br/>[typography.py]"]
  node_color_palettes["Color palettes<br/>[color_palettes.py]"]
  node_visual_effects["Visual effects<br/>[visual_effects.py]"]
  node_validators["GIF validation<br/>[validators.py]"]
  node_gif_output["GIF file"]
end

node_user(("Skill user"))
node_codex(("Codex"))

node_user -->|"requests install"| node_installer
node_installer -->|"uses fetch helpers"| node_github_utils
node_installer -->|"installs bundle"| node_skill_bundle
node_skill_bundle -->|"loads metadata"| node_codex
node_codex -->|"matches task"| node_skill_metadata
node_codex -->|"loads instructions"| node_skill_guidance
node_mcp_evaluation -->|"uses connections"| node_mcp_connections
node_author_package -->|"validates package"| node_author_validate
node_curated_listing -->|"uses fetch helpers"| node_github_utils
node_gif_templates -.->|"assembles frames"| node_gif_builder
node_gif_templates -.->|"draws frames"| node_frame_composer
node_gif_templates -.->|"calculates motion"| node_easing
node_gif_templates -.->|"renders text"| node_typography
node_gif_templates -.->|"uses palettes"| node_color_palettes
node_gif_templates -.->|"applies effects"| node_visual_effects
node_gif_builder -.->|"saves GIF"| node_gif_output

click node_skill_bundle "https://github.com/composio-community/awesome-codex-skills/tree/master/composio-skills"
click node_installer "https://github.com/composio-community/awesome-codex-skills/blob/master/skill-installer/scripts/install-skill-from-github.py"
click node_github_utils "https://github.com/composio-community/awesome-codex-skills/blob/master/skill-installer/scripts/github_utils.py"
click node_skill_metadata "https://github.com/composio-community/awesome-codex-skills/tree/master/composio-skills"
click node_skill_guidance "https://github.com/composio-community/awesome-codex-skills/tree/master/composio-skills"
click node_author_init "https://github.com/composio-community/awesome-codex-skills/blob/master/skill-creator/scripts/init_skill.py"
click node_author_validate "https://github.com/composio-community/awesome-codex-skills/blob/master/skill-creator/scripts/quick_validate.py"
click node_author_package "https://github.com/composio-community/awesome-codex-skills/blob/master/skill-creator/scripts/package_skill.py"
click node_mcp_connections "https://github.com/composio-community/awesome-codex-skills/blob/master/mcp-builder/scripts/connections.py"
click node_mcp_evaluation "https://github.com/composio-community/awesome-codex-skills/blob/master/mcp-builder/scripts/evaluation.py"
click node_curated_listing "https://github.com/composio-community/awesome-codex-skills/blob/master/skill-installer/scripts/list-curated-skills.py"
click node_pr_comments "https://github.com/composio-community/awesome-codex-skills/blob/master/gh-address-comments/scripts/fetch_comments.py"
click node_ci_inspection "https://github.com/composio-community/awesome-codex-skills/blob/master/gh-fix-ci/scripts/inspect_pr_checks.py"
click node_gif_templates "https://github.com/composio-community/awesome-codex-skills/tree/master/slack-gif-creator/templates"
click node_gif_builder "https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/gif_builder.py"
click node_frame_composer "https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/frame_composer.py"
click node_easing "https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/easing.py"
click node_typography "https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/typography.py"
click node_color_palettes "https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/color_palettes.py"
click node_visual_effects "https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/visual_effects.py"
click node_validators "https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/validators.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_skill_bundle,node_installer,node_github_utils,node_skill_metadata,node_skill_guidance,node_curated_listing,node_user toneBlue
class node_author_init,node_author_validate,node_author_package toneAmber
class node_mcp_connections,node_mcp_evaluation toneMint
class node_pr_comments,node_ci_inspection toneRose
class node_gif_templates,node_gif_builder,node_frame_composer,node_easing,node_typography,node_color_palettes,node_visual_effects,node_validators,node_gif_output,node_codex toneIndigo
```

## Components

### Skill catalog

- [Skill bundles](https://github.com/composio-community/awesome-codex-skills/tree/master/composio-skills): `composio-skills`
- [Skill installer](https://github.com/composio-community/awesome-codex-skills/blob/master/skill-installer/scripts/install-skill-from-github.py): `skill-installer/scripts/install-skill-from-github.py`
- [GitHub fetch helpers](https://github.com/composio-community/awesome-codex-skills/blob/master/skill-installer/scripts/github_utils.py): `skill-installer/scripts/github_utils.py`
- [Skill metadata](https://github.com/composio-community/awesome-codex-skills/tree/master/composio-skills): `composio-skills`
- [Skill guidance](https://github.com/composio-community/awesome-codex-skills/tree/master/composio-skills): `composio-skills`
- [Curated listing](https://github.com/composio-community/awesome-codex-skills/blob/master/skill-installer/scripts/list-curated-skills.py): `skill-installer/scripts/list-curated-skills.py`

### Skill authoring

- [Initialize skill](https://github.com/composio-community/awesome-codex-skills/blob/master/skill-creator/scripts/init_skill.py): `skill-creator/scripts/init_skill.py`
- [Validate skill](https://github.com/composio-community/awesome-codex-skills/blob/master/skill-creator/scripts/quick_validate.py): `skill-creator/scripts/quick_validate.py`
- [Package skill](https://github.com/composio-community/awesome-codex-skills/blob/master/skill-creator/scripts/package_skill.py): `skill-creator/scripts/package_skill.py`

### MCP tools

- [MCP connections](https://github.com/composio-community/awesome-codex-skills/blob/master/mcp-builder/scripts/connections.py): `mcp-builder/scripts/connections.py`
- [MCP evaluation](https://github.com/composio-community/awesome-codex-skills/blob/master/mcp-builder/scripts/evaluation.py): `mcp-builder/scripts/evaluation.py`

### Workflow helpers

- [PR comments](https://github.com/composio-community/awesome-codex-skills/blob/master/gh-address-comments/scripts/fetch_comments.py): `gh-address-comments/scripts/fetch_comments.py`
- [CI inspection](https://github.com/composio-community/awesome-codex-skills/blob/master/gh-fix-ci/scripts/inspect_pr_checks.py): `gh-fix-ci/scripts/inspect_pr_checks.py`

### GIF generation

- [Animation templates](https://github.com/composio-community/awesome-codex-skills/tree/master/slack-gif-creator/templates): `slack-gif-creator/templates`
- [GIF builder](https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/gif_builder.py): `slack-gif-creator/core/gif_builder.py`
- [Frame composition](https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/frame_composer.py): `slack-gif-creator/core/frame_composer.py`
- [Motion easing](https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/easing.py): `slack-gif-creator/core/easing.py`
- [Typography](https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/typography.py): `slack-gif-creator/core/typography.py`
- [Color palettes](https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/color_palettes.py): `slack-gif-creator/core/color_palettes.py`
- [Visual effects](https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/visual_effects.py): `slack-gif-creator/core/visual_effects.py`
- [GIF validation](https://github.com/composio-community/awesome-codex-skills/blob/master/slack-gif-creator/core/validators.py): `slack-gif-creator/core/validators.py`
- **GIF file**

### Other components

- **Skill user**
- **Codex**

## Connections

- Skill user → Skill installer: requests install (evidence: `README.md`)
- Skill installer → GitHub fetch helpers: uses fetch helpers (evidence: `skill-installer/scripts/install-skill-from-github.py`)
- Skill installer → Skill bundles: installs bundle (evidence: `README.md`)
- Skill bundles → Codex: loads metadata (evidence: `README.md`)
- Codex → Skill metadata: matches task (evidence: `README.md`)
- Codex → Skill guidance: loads instructions (evidence: `README.md`)
- MCP evaluation → MCP connections: uses connections (evidence: `mcp-builder/scripts/evaluation.py`)
- Package skill → Validate skill: validates package (evidence: `skill-creator/scripts/package_skill.py`)
- Curated listing → GitHub fetch helpers: uses fetch helpers (evidence: `skill-installer/scripts/list-curated-skills.py`)
- Animation templates → GIF builder: assembles frames (evidence: `slack-gif-creator/templates/bounce.py`)
- Animation templates → Frame composition: draws frames (evidence: `slack-gif-creator/templates/fade.py`)
- Animation templates → Motion easing: calculates motion (evidence: `slack-gif-creator/templates/bounce.py`)
- Animation templates → Typography: renders text (evidence: `slack-gif-creator/templates/fade.py`)
- Animation templates → Color palettes: uses palettes (evidence: `slack-gif-creator/templates/explode.py`)
- Animation templates → Visual effects: applies effects (evidence: `slack-gif-creator/templates/explode.py`)
- GIF builder → GIF file: saves GIF