The AgenTopology Skill

The AgenTopology skill is an interactive builder that ships with the agentopology package. Describe what you want in plain language, and the skill generates a complete .at file, validates it, scaffolds platform configs, and visualizes the agent graph -- all in under two minutes.

How it works

You describe a task naturally. The skill handles the rest:

1. Describe -- Tell the skill what your agent team should do
2. Generate -- The skill picks the right pattern and writes a .at file
3. Validate -- 82 validation rules check the topology for errors
4. Scaffold -- Platform-specific config files are generated
5. Visualize -- An interactive graph shows your agent topology

Four modes

The skill operates in four modes. Build mode is the primary experience.

Build mode

The main mode. You describe a task, and the skill walks you through generating a complete topology. It asks clarifying questions, picks the best pattern, and produces a validated .at file.

/agentopology build

Validate mode

Run the 82-rule validator against an existing .at file. Catches missing agents, unreachable nodes, invalid flow conditions, and more.

/agentopology validate

Scaffold mode

Generate platform-specific config files from a .at file. Supports Claude Code, Codex, Cursor, Gemini CLI, Copilot CLI, and OpenClaw.

/agentopology scaffold

Visualize mode

Generate an interactive HTML visualization of your agent graph, showing agents, flow edges, and conditional routing.

/agentopology visualize

Why use the skill

Writing .at files by hand works well once you know the language. The skill is for when you want to move fast:

• No syntax to memorize -- Describe your agents in plain English
• Pattern selection -- The skill picks the right architecture pattern for your use case
• Instant validation -- Errors are caught before you scaffold
• End-to-end -- Go from idea to deployed agent team without leaving your editor

What's next

• Install the skill in your environment
• Walk through building a topology with the skill
• See the available templates the skill recommends