<a id="ref-ai-agents"></a>

# Workshop and AI agents

<!-- @artefact SDK -->
<!-- @artefact workshop (container) -->

**Workshop** integrates with AI coding agents,
exposing documentation as Markdown that agents can fetch and parse directly,
or retrieve through Context7,
and agentic skills that wrap **Workshop** and **SDKcraft** operations
so agents don’t have to rediscover the CLIs every session.

<a id="ref-ai-discovery"></a>

## LLM-readable docs

**Workshop** publishes two files that follow the
[llms.txt convention](https://llmstxt.org/):
[llms.txt](https://ubuntu.com/workshop/docs/llms.txt)
indexes every page with a one-line summary,
and [llms-full.txt](https://ubuntu.com/workshop/docs/llms-full.txt)
concatenates every page as Markdown.

To fetch a single page as Markdown,
append `.md` to its URL.
For example,
this page is available at
`https://ubuntu.com/workshop/docs/reference/ai-agents.md`.

<a id="ref-ai-context7"></a>

## Context7

[Context7](https://context7.com/canonical/workshop)
indexes the **Workshop** documentation
and serves it to AI agents through its Model Context Protocol (MCP) server,
so agents can pull current docs without scraping the site.

<a id="ref-ai-use-workshop-skill"></a>

## The use-workshop skill

The [use-workshop-skill](https://github.com/canonical/use-workshop-skill) repository
ships an agentic skill for operating the **Workshop** CLI:
launching workshops,
refreshing them,
running commands inside,
wiring interfaces,
debugging failed changes,
and orchestrating parallel environments via Git worktrees.

To enable it in a repository,
copy `.github/skills/use-workshop/` into the target repo,
using the skills path for your agent
(`.claude/skills/` for Claude Code,
`.github/skills/` for Copilot).
Mention **Workshop** in any prompt to trigger the skill.

<a id="ref-ai-sdk-designer-skill"></a>

## The sdk-designer skill

The [template-sdk](https://github.com/canonical/template-sdk) repository
ships an agentic skill named `sdk-designer`.
The skill runs an interactive scaffolding conversation:
it asks about the software to package,
the target platforms,
and which interfaces and hooks are needed,
then writes the corresponding files into the template.

1. Aim the agent at the new repository.
2. Run `/sdk-designer` and answer the prompts.
3. Review the generated files
   and adjust where the skill’s defaults don’t match your case.