Workshop and AI agents

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

LLM-readable docs

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.

The use-workshop skill

The 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.

The sdk-designer skill

The 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.

See also

How-to guides: