# `AgentWorkshop.Skills`
[🔗](https://github.com/joshrotenberg/agent_workshop/blob/main/lib/agent_workshop/skills.ex#L1)

Loads skill content and AGENTS.md for injection into agent system prompts.

Skills are markdown files following the agentskills.io format, stored
in the `skills/` directory of the agent_workshop package.

AGENTS.md provides top-level context for any agent with Workshop tools.

# `agents_md`

```elixir
@spec agents_md() :: String.t() | nil
```

Load the AGENTS.md content from the package.

# `context_for`

```elixir
@spec context_for(keyword()) :: String.t() | nil
```

Build context string for an agent based on its role.

For `workshop_tools: true` agents, includes the orchestrator section
from AGENTS.md. For agents with a `:skill` option, includes that
skill's content.

# `list`

```elixir
@spec list() :: [atom()]
```

List available skill names.

# `skill`

```elixir
@spec skill(atom()) :: String.t() | nil
```

Load a skill's SKILL.md content by name.

---

*Consult [api-reference.md](api-reference.md) for complete listing*