# anthropics/skills architecture

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

- Interactive diagram: https://gitdiagram.com/anthropics/skills
- Repository: https://github.com/anthropics/skills
- Video tour (about a minute): https://gitdiagram.com/anthropics/skills/video

## Overview

This repository is a collection of Claude skills: self-contained instruction, script, and resource folders dynamically loaded for specialized tasks. The documented workflow starts when a user requests a task, Claude applies a relevant skill, and its instructions and scripts support the result. Major branches include document editing and validation, skill creation and evaluation, creative generation, and technical/API workflows. The README establishes the overall loading model; sampled source supports only the specific internal calls shown, so other links are omitted.

Main entry points: [`skills/docx`](https://github.com/anthropics/skills/tree/main/skills/docx) (Word documents), [`skills/pptx`](https://github.com/anthropics/skills/tree/main/skills/pptx) (Presentations), [`skills/xlsx`](https://github.com/anthropics/skills/tree/main/skills/xlsx) (Spreadsheets), [`skills/skill-creator/scripts/run_loop.py`](https://github.com/anthropics/skills/blob/main/skills/skill-creator/scripts/run_loop.py) (Evaluation loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_docs["Document skills"]
  node_docx["Word documents"]
  node_pdf["PDF forms"]
  node_pptx["Presentations"]
  node_xlsx["Spreadsheets"]
  node_office_helpers["Office package helpers"]
  node_office_validate["Office validation<br/>[base.py]"]
  node_office_conversion["LibreOffice runner<br/>[soffice.py]"]
  node_pdf_fields["Field extraction"]
  node_pdf_fill["Form filling"]
  node_xlsx_recalc["Formula recalculation<br/>[recalc.py]"]
end

subgraph group_authoring["Skill creation"]
  node_skill_creator["Skill authoring"]
  node_eval_loop["Evaluation loop<br/>[run_loop.py]"]
  node_eval_report["Evaluation reports<br/>[generate_report.py]"]
  node_benchmark["Benchmark aggregation"]
end

subgraph group_creative["Creative skills"]
  node_slack_gif["Slack GIF creation"]
  node_gif_builder["GIF rendering<br/>[gif_builder.py]"]
  node_gif_validation["GIF validation<br/>[validators.py]"]
  node_algorithmic_art["Algorithmic art"]
end

subgraph group_technical["Technical workflows"]
  node_mcp_builder["MCP server building"]
  node_mcp_connections["MCP connections<br/>[connections.py]"]
  node_api_migration["Thinking migration probes"]
  node_drop_probe["Request replay probe"]
  node_prefix_diff["Request prefix diff<br/>[prefix_diff.py]"]
  node_web_testing["Web app testing"]
end

node_user(("User"))
node_claude["Claude skill runtime"]

node_user -->|"requests task"| node_claude
node_claude -->|"loads skill"| node_docx
node_claude -->|"loads skill"| node_pdf
node_claude -->|"loads skill"| node_pptx
node_claude -->|"loads skill"| node_xlsx
node_claude -->|"loads skill"| node_skill_creator
node_claude -->|"loads skill"| node_mcp_builder
node_claude -->|"loads skill"| node_api_migration
node_claude -->|"loads skill"| node_web_testing
node_claude -->|"loads skill"| node_slack_gif
node_claude -->|"loads skill"| node_algorithmic_art
node_docx -.->|"validates packages"| node_office_validate
node_docx -.->|"runs conversion"| node_office_conversion
node_pptx -.->|"validates packages"| node_office_validate
node_xlsx -.->|"validates packages"| node_office_validate
node_pptx -.->|"uses helpers"| node_office_helpers
node_pdf -.->|"fills fields"| node_pdf_fill
node_pdf_fill -->|"reads field metadata"| node_pdf_fields
node_xlsx -.->|"recalculates formulas"| node_xlsx_recalc
node_skill_creator -.->|"runs evaluations"| node_eval_loop
node_eval_loop -->|"generates report"| node_eval_report
node_eval_loop -.->|"aggregates results"| node_benchmark
node_mcp_builder -.->|"configures connections"| node_mcp_connections
node_api_migration -.->|"replays requests"| node_drop_probe
node_drop_probe -->|"compares requests"| node_prefix_diff
node_slack_gif -.->|"builds animation"| node_gif_builder
node_slack_gif -.->|"checks output"| node_gif_validation

click node_docx "https://github.com/anthropics/skills/tree/main/skills/docx"
click node_pdf "https://github.com/anthropics/skills/tree/main/skills/pdf"
click node_pptx "https://github.com/anthropics/skills/tree/main/skills/pptx"
click node_xlsx "https://github.com/anthropics/skills/tree/main/skills/xlsx"
click node_office_helpers "https://github.com/anthropics/skills/tree/main/skills/docx/scripts/office/helpers"
click node_office_validate "https://github.com/anthropics/skills/blob/main/skills/docx/scripts/office/validators/base.py"
click node_office_conversion "https://github.com/anthropics/skills/blob/main/skills/docx/scripts/office/soffice.py"
click node_pdf_fields "https://github.com/anthropics/skills/blob/main/skills/pdf/scripts/extract_form_field_info.py"
click node_pdf_fill "https://github.com/anthropics/skills/blob/main/skills/pdf/scripts/fill_fillable_fields.py"
click node_xlsx_recalc "https://github.com/anthropics/skills/blob/main/skills/xlsx/scripts/recalc.py"
click node_skill_creator "https://github.com/anthropics/skills/tree/main/skills/skill-creator"
click node_eval_loop "https://github.com/anthropics/skills/blob/main/skills/skill-creator/scripts/run_loop.py"
click node_eval_report "https://github.com/anthropics/skills/blob/main/skills/skill-creator/scripts/generate_report.py"
click node_benchmark "https://github.com/anthropics/skills/blob/main/skills/skill-creator/scripts/aggregate_benchmark.py"
click node_mcp_builder "https://github.com/anthropics/skills/tree/main/skills/mcp-builder"
click node_mcp_connections "https://github.com/anthropics/skills/blob/main/skills/mcp-builder/scripts/connections.py"
click node_api_migration "https://github.com/anthropics/skills/tree/main/skills/claude-api/shared/preserved-thinking-migration"
click node_drop_probe "https://github.com/anthropics/skills/blob/main/skills/claude-api/shared/preserved-thinking-migration/drop_block_probe.py"
click node_prefix_diff "https://github.com/anthropics/skills/blob/main/skills/claude-api/shared/preserved-thinking-migration/prefix_diff.py"
click node_web_testing "https://github.com/anthropics/skills/tree/main/skills/webapp-testing"
click node_slack_gif "https://github.com/anthropics/skills/tree/main/skills/slack-gif-creator"
click node_gif_builder "https://github.com/anthropics/skills/blob/main/skills/slack-gif-creator/core/gif_builder.py"
click node_gif_validation "https://github.com/anthropics/skills/blob/main/skills/slack-gif-creator/core/validators.py"
click node_algorithmic_art "https://github.com/anthropics/skills/tree/main/skills/algorithmic-art"

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_docx,node_pdf,node_pptx,node_xlsx,node_office_helpers,node_office_validate,node_office_conversion,node_pdf_fields,node_pdf_fill,node_xlsx_recalc,node_user toneBlue
class node_skill_creator,node_eval_loop,node_eval_report,node_benchmark toneAmber
class node_slack_gif,node_gif_builder,node_gif_validation,node_algorithmic_art toneMint
class node_mcp_builder,node_mcp_connections,node_api_migration,node_drop_probe,node_prefix_diff,node_web_testing toneRose
class node_claude toneIndigo
```

## Components

### Document skills

- [Word documents](https://github.com/anthropics/skills/tree/main/skills/docx): `skills/docx`
- [PDF forms](https://github.com/anthropics/skills/tree/main/skills/pdf): `skills/pdf`
- [Presentations](https://github.com/anthropics/skills/tree/main/skills/pptx): `skills/pptx`
- [Spreadsheets](https://github.com/anthropics/skills/tree/main/skills/xlsx): `skills/xlsx`
- [Office package helpers](https://github.com/anthropics/skills/tree/main/skills/docx/scripts/office/helpers): `skills/docx/scripts/office/helpers`
- [Office validation](https://github.com/anthropics/skills/blob/main/skills/docx/scripts/office/validators/base.py): `skills/docx/scripts/office/validators/base.py`
- [LibreOffice runner](https://github.com/anthropics/skills/blob/main/skills/docx/scripts/office/soffice.py): `skills/docx/scripts/office/soffice.py`
- [Field extraction](https://github.com/anthropics/skills/blob/main/skills/pdf/scripts/extract_form_field_info.py): `skills/pdf/scripts/extract_form_field_info.py`
- [Form filling](https://github.com/anthropics/skills/blob/main/skills/pdf/scripts/fill_fillable_fields.py): `skills/pdf/scripts/fill_fillable_fields.py`
- [Formula recalculation](https://github.com/anthropics/skills/blob/main/skills/xlsx/scripts/recalc.py): `skills/xlsx/scripts/recalc.py`

### Skill creation

- [Skill authoring](https://github.com/anthropics/skills/tree/main/skills/skill-creator): `skills/skill-creator`
- [Evaluation loop](https://github.com/anthropics/skills/blob/main/skills/skill-creator/scripts/run_loop.py): `skills/skill-creator/scripts/run_loop.py`
- [Evaluation reports](https://github.com/anthropics/skills/blob/main/skills/skill-creator/scripts/generate_report.py): `skills/skill-creator/scripts/generate_report.py`
- [Benchmark aggregation](https://github.com/anthropics/skills/blob/main/skills/skill-creator/scripts/aggregate_benchmark.py): `skills/skill-creator/scripts/aggregate_benchmark.py`

### Creative skills

- [Slack GIF creation](https://github.com/anthropics/skills/tree/main/skills/slack-gif-creator): `skills/slack-gif-creator`
- [GIF rendering](https://github.com/anthropics/skills/blob/main/skills/slack-gif-creator/core/gif_builder.py): `skills/slack-gif-creator/core/gif_builder.py`
- [GIF validation](https://github.com/anthropics/skills/blob/main/skills/slack-gif-creator/core/validators.py): `skills/slack-gif-creator/core/validators.py`
- [Algorithmic art](https://github.com/anthropics/skills/tree/main/skills/algorithmic-art): `skills/algorithmic-art`

### Technical workflows

- [MCP server building](https://github.com/anthropics/skills/tree/main/skills/mcp-builder): `skills/mcp-builder`
- [MCP connections](https://github.com/anthropics/skills/blob/main/skills/mcp-builder/scripts/connections.py): `skills/mcp-builder/scripts/connections.py`
- [Thinking migration probes](https://github.com/anthropics/skills/tree/main/skills/claude-api/shared/preserved-thinking-migration): `skills/claude-api/shared/preserved-thinking-migration`
- [Request replay probe](https://github.com/anthropics/skills/blob/main/skills/claude-api/shared/preserved-thinking-migration/drop_block_probe.py): `skills/claude-api/shared/preserved-thinking-migration/drop_block_probe.py`
- [Request prefix diff](https://github.com/anthropics/skills/blob/main/skills/claude-api/shared/preserved-thinking-migration/prefix_diff.py): `skills/claude-api/shared/preserved-thinking-migration/prefix_diff.py`
- [Web app testing](https://github.com/anthropics/skills/tree/main/skills/webapp-testing): `skills/webapp-testing`

### Other components

- **User**
- **Claude skill runtime**

## Connections

- User → Claude skill runtime: requests task
- Claude skill runtime → Word documents: loads skill
- Claude skill runtime → PDF forms: loads skill
- Claude skill runtime → Presentations: loads skill
- Claude skill runtime → Spreadsheets: loads skill
- Claude skill runtime → Skill authoring: loads skill
- Claude skill runtime → MCP server building: loads skill
- Claude skill runtime → Thinking migration probes: loads skill
- Claude skill runtime → Web app testing: loads skill
- Claude skill runtime → Slack GIF creation: loads skill
- Claude skill runtime → Algorithmic art: loads skill
- Word documents → Office validation: validates packages (evidence: `skills/docx/scripts/office/validators/pptx.py`)
- Word documents → LibreOffice runner: runs conversion
- Presentations → Office validation: validates packages
- Spreadsheets → Office validation: validates packages
- Presentations → Office package helpers: uses helpers (evidence: `skills/pptx/scripts/add_slide.py`)
- PDF forms → Form filling: fills fields (evidence: `skills/pdf/scripts/fill_fillable_fields.py`)
- Form filling → Field extraction: reads field metadata (evidence: `skills/pdf/scripts/fill_fillable_fields.py`)
- Spreadsheets → Formula recalculation: recalculates formulas
- Skill authoring → Evaluation loop: runs evaluations (evidence: `skills/skill-creator/scripts/run_loop.py`)
- Evaluation loop → Evaluation reports: generates report (evidence: `skills/skill-creator/scripts/run_loop.py`)
- Evaluation loop → Benchmark aggregation: aggregates results
- MCP server building → MCP connections: configures connections (evidence: `skills/mcp-builder/scripts/evaluation.py`)
- Thinking migration probes → Request replay probe: replays requests (evidence: `skills/claude-api/shared/preserved-thinking-migration/drop_block_probe.py`)
- Request replay probe → Request prefix diff: compares requests (evidence: `skills/claude-api/shared/preserved-thinking-migration/drop_block_probe.py`)
- Slack GIF creation → GIF rendering: builds animation
- Slack GIF creation → GIF validation: checks output
