# apify/agent-skills architecture

> Architecture diagram of the GitHub repository apify/agent-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/apify/agent-skills
- Repository: https://github.com/apify/agent-skills

## Overview

Apify Agent Skills is a collection of instructions and reference material that equips AI coding agents to work with the Apify platform. The main user workflow is a natural-language scraping request: the agent selects an Actor, shapes its input, manages the run, and formats results. Other major capabilities cover building Actors, wrapping existing code as Actors, and integrating Apify into products. The graph follows the README’s documented workflows and capability areas; individual skill instructions were not sampled, so internal implementation links are limited to those documented relationships.

Main entry points: [`skills/apify-ultimate-scraper/SKILL.md`](https://github.com/apify/agent-skills/blob/main/skills/apify-ultimate-scraper/SKILL.md) (Scraper skill), [`skills/apify-actor-development/SKILL.md`](https://github.com/apify/agent-skills/blob/main/skills/apify-actor-development/SKILL.md) (Actor development), [`skills/apify-integration-development/SKILL.md`](https://github.com/apify/agent-skills/blob/main/skills/apify-integration-development/SKILL.md) (Integration development), [`skills/apify-actorization/SKILL.md`](https://github.com/apify/agent-skills/blob/main/skills/apify-actorization/SKILL.md) (Code actorization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scraping["Scraping workflows"]
  node_scraper_skill["Scraper skill<br/>[SKILL.md]"]
  node_actor_catalog["Actor selection<br/>[actor-index.md]"]
  node_use_case_workflows["Scraping workflows"]
end

subgraph group_actor_building["Actor development"]
  node_actor_dev["Actor development<br/>[SKILL.md]"]
  node_actor_guides["Actor references"]
  node_schema_generation["Schema generation<br/>[SKILL.md]"]
  node_actorization["Code actorization<br/>[SKILL.md]"]
  node_actorization_guides["Actorization guides"]
end

subgraph group_integration["Product integration"]
  node_integration_skill["Integration development<br/>[SKILL.md]"]
  node_integration_guides["Integration guides"]
end

subgraph group_agent_access["Agent access"]
  node_actor_command["Actor command<br/>[create-actor.md]"]
  node_skill_index["Agent skill index<br/>[AGENTS.md]"]
end

node_user(("User"))
node_agent(("AI coding agent"))
node_apify_platform["Apify Actors"]
node_apify_client["Apify client or REST"]

node_user -->|"requests work"| node_agent
node_agent -->|"uses skill"| node_scraper_skill
node_scraper_skill -->|"selects Actor"| node_actor_catalog
node_scraper_skill -->|"guides workflows"| node_use_case_workflows
node_scraper_skill -->|"shapes input"| node_apify_platform
node_scraper_skill -->|"manages run"| node_apify_platform
node_apify_platform -->|"returns results"| node_scraper_skill
node_agent -->|"uses skill"| node_actor_dev
node_actor_dev -->|"uses references"| node_actor_guides
node_actor_dev -->|"includes schema work"| node_schema_generation
node_agent -->|"uses skill"| node_actorization
node_actorization -->|"supports languages"| node_actorization_guides
node_agent -->|"uses skill"| node_integration_skill
node_integration_skill -->|"covers integration types"| node_integration_guides
node_integration_skill -->|"supports clients"| node_apify_client
node_agent -->|"invokes command"| node_actor_command
node_agent -->|"discovers skills"| node_skill_index

click node_scraper_skill "https://github.com/apify/agent-skills/blob/main/skills/apify-ultimate-scraper/SKILL.md"
click node_actor_catalog "https://github.com/apify/agent-skills/blob/main/skills/apify-ultimate-scraper/references/actor-index.md"
click node_use_case_workflows "https://github.com/apify/agent-skills/tree/main/skills/apify-ultimate-scraper/references/workflows"
click node_actor_dev "https://github.com/apify/agent-skills/blob/main/skills/apify-actor-development/SKILL.md"
click node_actor_guides "https://github.com/apify/agent-skills/tree/main/skills/apify-actor-development/references"
click node_schema_generation "https://github.com/apify/agent-skills/blob/main/skills/apify-generate-output-schema/SKILL.md"
click node_actorization "https://github.com/apify/agent-skills/blob/main/skills/apify-actorization/SKILL.md"
click node_actorization_guides "https://github.com/apify/agent-skills/tree/main/skills/apify-actorization/references"
click node_integration_skill "https://github.com/apify/agent-skills/blob/main/skills/apify-integration-development/SKILL.md"
click node_integration_guides "https://github.com/apify/agent-skills/tree/main/skills/apify-integration-development/references"
click node_actor_command "https://github.com/apify/agent-skills/blob/main/commands/create-actor.md"
click node_skill_index "https://github.com/apify/agent-skills/blob/main/agents/AGENTS.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_scraper_skill,node_actor_catalog,node_use_case_workflows,node_user,node_apify_client toneBlue
class node_actor_dev,node_actor_guides,node_schema_generation,node_actorization,node_actorization_guides toneAmber
class node_integration_skill,node_integration_guides,node_apify_platform toneMint
class node_actor_command,node_skill_index toneRose
class node_agent toneIndigo
```

## Components

### Scraping workflows

- [Scraper skill](https://github.com/apify/agent-skills/blob/main/skills/apify-ultimate-scraper/SKILL.md): `skills/apify-ultimate-scraper/SKILL.md`
- [Actor selection](https://github.com/apify/agent-skills/blob/main/skills/apify-ultimate-scraper/references/actor-index.md): `skills/apify-ultimate-scraper/references/actor-index.md`
- [Scraping workflows](https://github.com/apify/agent-skills/tree/main/skills/apify-ultimate-scraper/references/workflows): `skills/apify-ultimate-scraper/references/workflows`

### Actor development

- [Actor development](https://github.com/apify/agent-skills/blob/main/skills/apify-actor-development/SKILL.md): `skills/apify-actor-development/SKILL.md`
- [Actor references](https://github.com/apify/agent-skills/tree/main/skills/apify-actor-development/references): `skills/apify-actor-development/references`
- [Schema generation](https://github.com/apify/agent-skills/blob/main/skills/apify-generate-output-schema/SKILL.md): `skills/apify-generate-output-schema/SKILL.md`
- [Code actorization](https://github.com/apify/agent-skills/blob/main/skills/apify-actorization/SKILL.md): `skills/apify-actorization/SKILL.md`
- [Actorization guides](https://github.com/apify/agent-skills/tree/main/skills/apify-actorization/references): `skills/apify-actorization/references`

### Product integration

- [Integration development](https://github.com/apify/agent-skills/blob/main/skills/apify-integration-development/SKILL.md): `skills/apify-integration-development/SKILL.md`
- [Integration guides](https://github.com/apify/agent-skills/tree/main/skills/apify-integration-development/references): `skills/apify-integration-development/references`

### Agent access

- [Actor command](https://github.com/apify/agent-skills/blob/main/commands/create-actor.md): `commands/create-actor.md`
- [Agent skill index](https://github.com/apify/agent-skills/blob/main/agents/AGENTS.md): `agents/AGENTS.md`

### Other components

- **User**
- **AI coding agent**
- **Apify Actors**
- **Apify client or REST**

## Connections

- User → AI coding agent: requests work (evidence: `README.md`)
- AI coding agent → Scraper skill: uses skill (evidence: `README.md`)
- Scraper skill → Actor selection: selects Actor (evidence: `README.md`)
- Scraper skill → Scraping workflows: guides workflows (evidence: `README.md`)
- Scraper skill → Apify Actors: shapes input (evidence: `README.md`)
- Scraper skill → Apify Actors: manages run (evidence: `README.md`)
- Apify Actors → Scraper skill: returns results (evidence: `README.md`)
- AI coding agent → Actor development: uses skill (evidence: `README.md`)
- Actor development → Actor references: uses references (evidence: `README.md`)
- Actor development → Schema generation: includes schema work (evidence: `README.md`)
- AI coding agent → Code actorization: uses skill (evidence: `README.md`)
- Code actorization → Actorization guides: supports languages (evidence: `README.md`)
- AI coding agent → Integration development: uses skill (evidence: `README.md`)
- Integration development → Integration guides: covers integration types (evidence: `README.md`)
- Integration development → Apify client or REST: supports clients (evidence: `README.md`)
- AI coding agent → Actor command: invokes command (evidence: `README.md`)
- AI coding agent → Agent skill index: discovers skills (evidence: `README.md`)