# seb1n/awesome-ai-agent-skills architecture

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

- Interactive diagram: https://gitdiagram.com/seb1n/awesome-ai-agent-skills
- Repository: https://github.com/seb1n/awesome-ai-agent-skills

## Overview

Awesome AI Agent Skills is a catalog of installable, self-contained instruction workflows—not an agent runtime. The principal path is a builder choosing skills, installing them with the Skills CLI, and a compatible agent loading a relevant skill to guide a task. The catalog spans agent engineering and security as well as broad technical and business domains. Optional bundled scripts, references, and assets deepen individual workflows. Source excerpts show several helper tools, but not their invocation from particular skill instructions, so those links are not inferred.

Main entry points: [`README.md`](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/README.md) (Skill Catalog), [`agent-engineering`](https://github.com/seb1n/awesome-ai-agent-skills/tree/main/agent-engineering) (Agent Engineering), [`agent-engineering/agent-evaluation/SKILL.md`](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/agent-evaluation/SKILL.md) (Agent Evaluation), [`agent-engineering/agent-observability/SKILL.md`](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/agent-observability/SKILL.md) (Agent Observability)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_engineering["Agent Engineering"]
  node_agent_eng["Agent Engineering"]
  node_evaluation["Agent Evaluation<br/>[SKILL.md]"]
  node_evaluation_tool["Evaluation Aggregator"]
  node_observability["Agent Observability<br/>[SKILL.md]"]
  node_trace_tool["Trace Summarizer"]
  node_human_gate["Human Approval Gates<br/>[SKILL.md]"]
  node_gate_validator["Gate Policy Validator"]
  node_mcp["MCP Server Building<br/>[SKILL.md]"]
  node_mcp_validator["MCP Manifest Validator"]
  node_orchestration["Multi-Agent Orchestration<br/>[SKILL.md]"]
  node_plan_validator["Plan Validator<br/>[validate_plan.py]"]
  node_tool_schema["Tool Schema Design<br/>[SKILL.md]"]
  node_schema_validator["Schema Validator"]
end

subgraph group_security["Agent Security"]
  node_security_skills["Security Skills"]
  node_red_team["Agent Red Teaming<br/>[SKILL.md]"]
  node_campaign_scorer["Campaign Scorer<br/>[score_campaign.py]"]
  node_injection["Prompt Injection Defense<br/>[SKILL.md]"]
  node_boundary_audit["Boundary Auditor"]
  node_supply_audit["Supply Chain Audit<br/>[SKILL.md]"]
  node_skill_auditor["Skill Auditor<br/>[audit_skill.py]"]
end

subgraph group_technical["Technical Skills"]
  node_technical["Technical Domains"]
  node_data_skills["Data and Analytics"]
  node_pdf["PDF Processing<br/>[SKILL.md]"]
  node_pdf_inspector["PDF Inspector<br/>[inspect_pdf.py]"]
  node_spreadsheet["Spreadsheet Analysis<br/>[SKILL.md]"]
  node_table_profiler["Table Profiler<br/>[profile_table.py]"]
  node_ai_ml["AI/ML Operations"]
  node_api["API and Integration"]
  node_devops["DevOps and Infrastructure"]
end

subgraph group_business["Business Skills"]
  node_business["Business and Knowledge"]
end

node_builder(("Skill Builder"))
node_skills_cli["Skills CLI"]
node_agent(("Compatible Agent"))
node_catalog["Skill Catalog<br/>[README.md]"]

node_builder -->|"chooses skills"| node_catalog
node_builder -->|"runs install"| node_skills_cli
node_skills_cli -->|"lists and installs"| node_catalog
node_catalog -->|"agent loads relevant skill"| node_agent
node_catalog -->|"organizes skills"| node_agent_eng
node_catalog -->|"organizes skills"| node_security_skills
node_catalog -->|"organizes skills"| node_technical
node_catalog -->|"organizes skills"| node_data_skills
node_catalog -->|"organizes skills"| node_ai_ml
node_catalog -->|"organizes skills"| node_api
node_catalog -->|"organizes skills"| node_devops
node_catalog -->|"organizes skills"| node_business
node_catalog -->|"offers workflow"| node_evaluation
node_catalog -->|"offers workflow"| node_observability
node_catalog -->|"offers workflow"| node_human_gate
node_catalog -->|"offers workflow"| node_mcp
node_catalog -->|"offers workflow"| node_orchestration
node_catalog -->|"offers workflow"| node_tool_schema
node_catalog -->|"offers workflow"| node_red_team
node_catalog -->|"offers workflow"| node_injection
node_catalog -->|"offers workflow"| node_supply_audit
node_catalog -->|"offers workflow"| node_pdf
node_catalog -->|"offers workflow"| node_spreadsheet

click node_catalog "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/README.md"
click node_agent_eng "https://github.com/seb1n/awesome-ai-agent-skills/tree/main/agent-engineering"
click node_evaluation "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/agent-evaluation/SKILL.md"
click node_evaluation_tool "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/agent-evaluation/scripts/aggregate_results.py"
click node_observability "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/agent-observability/SKILL.md"
click node_trace_tool "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/agent-observability/scripts/summarize_traces.py"
click node_human_gate "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/human-in-the-loop/SKILL.md"
click node_gate_validator "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/human-in-the-loop/scripts/validate_gate_policy.py"
click node_mcp "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/mcp-server-building/SKILL.md"
click node_mcp_validator "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/mcp-server-building/scripts/validate_tool_manifest.py"
click node_orchestration "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/multi-agent-orchestration/SKILL.md"
click node_plan_validator "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/multi-agent-orchestration/scripts/validate_plan.py"
click node_tool_schema "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/tool-schema-design/SKILL.md"
click node_schema_validator "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/tool-schema-design/scripts/validate_tool_schema.py"
click node_security_skills "https://github.com/seb1n/awesome-ai-agent-skills/tree/main/agent-security"
click node_red_team "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/agent-red-teaming/SKILL.md"
click node_campaign_scorer "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/agent-red-teaming/scripts/score_campaign.py"
click node_injection "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/prompt-injection-defense/SKILL.md"
click node_boundary_audit "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/prompt-injection-defense/scripts/audit_boundary_manifest.py"
click node_supply_audit "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/skill-supply-chain-audit/SKILL.md"
click node_skill_auditor "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/skill-supply-chain-audit/scripts/audit_skill.py"
click node_technical "https://github.com/seb1n/awesome-ai-agent-skills/tree/main/code-and-development"
click node_data_skills "https://github.com/seb1n/awesome-ai-agent-skills/tree/main/data-and-analytics"
click node_pdf "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/documents-and-files/pdf-processing/SKILL.md"
click node_pdf_inspector "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/documents-and-files/pdf-processing/scripts/inspect_pdf.py"
click node_spreadsheet "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/documents-and-files/spreadsheet-analysis/SKILL.md"
click node_table_profiler "https://github.com/seb1n/awesome-ai-agent-skills/blob/main/documents-and-files/spreadsheet-analysis/scripts/profile_table.py"
click node_ai_ml "https://github.com/seb1n/awesome-ai-agent-skills/tree/main/ai-ml-operations"
click node_api "https://github.com/seb1n/awesome-ai-agent-skills/tree/main/api-and-integration"
click node_devops "https://github.com/seb1n/awesome-ai-agent-skills/tree/main/devops-and-infrastructure"
click node_business "https://github.com/seb1n/awesome-ai-agent-skills/tree/main/research-and-knowledge"

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_agent_eng,node_evaluation,node_evaluation_tool,node_observability,node_trace_tool,node_human_gate,node_gate_validator,node_mcp,node_mcp_validator,node_orchestration,node_plan_validator,node_tool_schema,node_schema_validator toneBlue
class node_security_skills,node_red_team,node_campaign_scorer,node_injection,node_boundary_audit,node_supply_audit,node_skill_auditor toneAmber
class node_technical,node_data_skills,node_pdf,node_pdf_inspector,node_spreadsheet,node_table_profiler,node_ai_ml,node_api,node_devops toneMint
class node_business toneRose
class node_builder,node_skills_cli,node_agent toneIndigo
class node_catalog toneTeal
```

## Components

### Agent Engineering

- [Agent Engineering](https://github.com/seb1n/awesome-ai-agent-skills/tree/main/agent-engineering): `agent-engineering`
- [Agent Evaluation](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/agent-evaluation/SKILL.md): `agent-engineering/agent-evaluation/SKILL.md`
- [Evaluation Aggregator](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/agent-evaluation/scripts/aggregate_results.py): `agent-engineering/agent-evaluation/scripts/aggregate_results.py`
- [Agent Observability](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/agent-observability/SKILL.md): `agent-engineering/agent-observability/SKILL.md`
- [Trace Summarizer](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/agent-observability/scripts/summarize_traces.py): `agent-engineering/agent-observability/scripts/summarize_traces.py`
- [Human Approval Gates](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/human-in-the-loop/SKILL.md): `agent-engineering/human-in-the-loop/SKILL.md`
- [Gate Policy Validator](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/human-in-the-loop/scripts/validate_gate_policy.py): `agent-engineering/human-in-the-loop/scripts/validate_gate_policy.py`
- [MCP Server Building](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/mcp-server-building/SKILL.md): `agent-engineering/mcp-server-building/SKILL.md`
- [MCP Manifest Validator](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/mcp-server-building/scripts/validate_tool_manifest.py): `agent-engineering/mcp-server-building/scripts/validate_tool_manifest.py`
- [Multi-Agent Orchestration](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/multi-agent-orchestration/SKILL.md): `agent-engineering/multi-agent-orchestration/SKILL.md`
- [Plan Validator](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/multi-agent-orchestration/scripts/validate_plan.py): `agent-engineering/multi-agent-orchestration/scripts/validate_plan.py`
- [Tool Schema Design](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/tool-schema-design/SKILL.md): `agent-engineering/tool-schema-design/SKILL.md`
- [Schema Validator](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-engineering/tool-schema-design/scripts/validate_tool_schema.py): `agent-engineering/tool-schema-design/scripts/validate_tool_schema.py`

### Agent Security

- [Security Skills](https://github.com/seb1n/awesome-ai-agent-skills/tree/main/agent-security): `agent-security`
- [Agent Red Teaming](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/agent-red-teaming/SKILL.md): `agent-security/agent-red-teaming/SKILL.md`
- [Campaign Scorer](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/agent-red-teaming/scripts/score_campaign.py): `agent-security/agent-red-teaming/scripts/score_campaign.py`
- [Prompt Injection Defense](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/prompt-injection-defense/SKILL.md): `agent-security/prompt-injection-defense/SKILL.md`
- [Boundary Auditor](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/prompt-injection-defense/scripts/audit_boundary_manifest.py): `agent-security/prompt-injection-defense/scripts/audit_boundary_manifest.py`
- [Supply Chain Audit](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/skill-supply-chain-audit/SKILL.md): `agent-security/skill-supply-chain-audit/SKILL.md`
- [Skill Auditor](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/agent-security/skill-supply-chain-audit/scripts/audit_skill.py): `agent-security/skill-supply-chain-audit/scripts/audit_skill.py`

### Technical Skills

- [Technical Domains](https://github.com/seb1n/awesome-ai-agent-skills/tree/main/code-and-development): `code-and-development`
- [Data and Analytics](https://github.com/seb1n/awesome-ai-agent-skills/tree/main/data-and-analytics): `data-and-analytics`
- [PDF Processing](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/documents-and-files/pdf-processing/SKILL.md): `documents-and-files/pdf-processing/SKILL.md`
- [PDF Inspector](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/documents-and-files/pdf-processing/scripts/inspect_pdf.py): `documents-and-files/pdf-processing/scripts/inspect_pdf.py`
- [Spreadsheet Analysis](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/documents-and-files/spreadsheet-analysis/SKILL.md): `documents-and-files/spreadsheet-analysis/SKILL.md`
- [Table Profiler](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/documents-and-files/spreadsheet-analysis/scripts/profile_table.py): `documents-and-files/spreadsheet-analysis/scripts/profile_table.py`
- [AI/ML Operations](https://github.com/seb1n/awesome-ai-agent-skills/tree/main/ai-ml-operations): `ai-ml-operations`
- [API and Integration](https://github.com/seb1n/awesome-ai-agent-skills/tree/main/api-and-integration): `api-and-integration`
- [DevOps and Infrastructure](https://github.com/seb1n/awesome-ai-agent-skills/tree/main/devops-and-infrastructure): `devops-and-infrastructure`

### Business Skills

- [Business and Knowledge](https://github.com/seb1n/awesome-ai-agent-skills/tree/main/research-and-knowledge): `research-and-knowledge`

### Other components

- **Skill Builder**
- **Skills CLI**
- **Compatible Agent**
- [Skill Catalog](https://github.com/seb1n/awesome-ai-agent-skills/blob/main/README.md): `README.md`

## Connections

- Skill Builder → Skill Catalog: chooses skills (evidence: `README.md`)
- Skill Builder → Skills CLI: runs install (evidence: `README.md`)
- Skills CLI → Skill Catalog: lists and installs (evidence: `README.md`)
- Skill Catalog → Compatible Agent: agent loads relevant skill (evidence: `README.md`)
- Skill Catalog → Agent Engineering: organizes skills (evidence: `README.md`)
- Skill Catalog → Security Skills: organizes skills (evidence: `README.md`)
- Skill Catalog → Technical Domains: organizes skills (evidence: `README.md`)
- Skill Catalog → Data and Analytics: organizes skills (evidence: `README.md`)
- Skill Catalog → AI/ML Operations: organizes skills (evidence: `README.md`)
- Skill Catalog → API and Integration: organizes skills (evidence: `README.md`)
- Skill Catalog → DevOps and Infrastructure: organizes skills (evidence: `README.md`)
- Skill Catalog → Business and Knowledge: organizes skills (evidence: `README.md`)
- Skill Catalog → Agent Evaluation: offers workflow (evidence: `README.md`)
- Skill Catalog → Agent Observability: offers workflow (evidence: `README.md`)
- Skill Catalog → Human Approval Gates: offers workflow (evidence: `README.md`)
- Skill Catalog → MCP Server Building: offers workflow (evidence: `README.md`)
- Skill Catalog → Multi-Agent Orchestration: offers workflow (evidence: `README.md`)
- Skill Catalog → Tool Schema Design: offers workflow (evidence: `README.md`)
- Skill Catalog → Agent Red Teaming: offers workflow (evidence: `README.md`)
- Skill Catalog → Prompt Injection Defense: offers workflow (evidence: `README.md`)
- Skill Catalog → Supply Chain Audit: offers workflow (evidence: `README.md`)
- Skill Catalog → PDF Processing: offers workflow (evidence: `README.md`)
- Skill Catalog → Spreadsheet Analysis: offers workflow (evidence: `README.md`)
