Use Workshop

Operate the Workshop CLI fluently — launch and refresh workshops, run commands inside them, manage interfaces, debug failed changes, and orchestrate parallel environments via git worktrees. Use when the user mentions workshop, .workshop.yaml, an LXD-backed dev environment, or wants to plan/edit a workshop definition.

9 stars 2 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add canonical/use-workshop-skill

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add canonical/use-workshop-skill --skill use-workshop
Manual install
git clone --depth 1 https://github.com/canonical/use-workshop-skill.git /tmp/use-workshop-skill
mkdir -p ~/.claude/skills
cp -r /tmp/use-workshop-skill/.github/skills/use-workshop ~/.claude/skills/use-workshop

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

<essential_principles>
Five rules that always apply to operating Workshop. These come first; every workflow assumes them.

1. **The workshop is an isolation boundary.** Processes running inside a workshop cannot reach host resources except through declared interface connections. State this when relevant; do not assume any specific workload runs inside. The boundary is an LXD container by default; `runtime: lxd-vm` (experimental; `confinement: virtual-machine` before 0.9.8) makes it a full VM with different rules — see `references/runtime.md` before answering anything about VM workshops.

2. **State changes are async.** Every mutating command produces a numbered `change` composed of `tasks`. To diagnose what happened, use `workshop changes` then `workshop tasks <ID>` — never guess.

3. **Refresh is non-destructive; prefer it to remove+launch.** If `workshop refresh` errors, rerun with `--wait-on-error` to pause in `Waiting`, investigate via `workshop shell`, then `--continue` (after fixing) or `--abort` (to revert). Constraint: `--wait-on-error` is single-workshop only.
Read the full skill on GitHub

Details

Skill name
use-workshop
Path
.github/skills/use-workshop/SKILL.md
License
GPL-3.0
Repo updated
18 November 2026

FAQ

What does the Use Workshop skill do?

Operate the Workshop CLI fluently — launch and refresh workshops, run commands inside them, manage interfaces, debug failed changes, and orchestrate parallel environments via git worktrees. Use when the user mentions workshop, .workshop.yaml, an LXD-backed dev environment, or wants to plan/edit a workshop definition.

How do I install the Use Workshop skill?

Claude Code plugin: /plugin marketplace add canonical/use-workshop-skill. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Use Workshop popular?

It lives in canonical/use-workshop-skill, which has 9 GitHub stars and 2 forks.

Related skills

Design SDK

9

canonical/use-workshop-skill

Design, build, and publish Workshop SDKs with sdkcraft — interview and research the software, generate sdkcraft.yaml with hooks and spread smoke tests, iterate via sdkcraft try plus workshop refresh, write the README, then onboard the SDK repo with version branches, CI workflows, and renovate. Use when creating or maintaining a publisher-side (Store) SDK from its own repository — "design an SDK for X", "create an sdkcraft.yaml", "set up renovate and CI for my SDK repo".

Software Development

Onboard Workshop

9

canonical/use-workshop-skill

Analyze an arbitrary repository and bootstrap a tailored Workshop definition from its existing build, test, and debug toolchain — feasibility verdict first, then propose, generate, launch, and verify. Use when a repo has no workshop definition yet and the user wants one derived from how the repo already builds and tests — "set up a workshop for this repo", "workshop-ify this project", "can this repo run in Workshop?".

Testing & QA

Wallet CLI Usage

9

LedgerHQ/agent-skills

Official Ledger wallet-cli - USB-based CLI for Ledger hardware wallet flows (account discover, receive, balances, operations, send, swap quote/execute/status, genuine-check, assets token / token-by-id), the Ledger Key Ring (ring init/encrypt/decrypt/keys/destroy — LKRP-backed encryption of files and text), and Agent Intent (agent-intent enroll/recover/list/show/sync/send/swap/intents/status/cancel — enroll or recover a remote agent's software identity, import the Ledger Sync accounts it was granted, propose Ethereum and Solana payments and Ethereum swaps for human review, list the intents it p

Software Development

Ledger Dmk Implementation

9

LedgerHQ/agent-skills

Execute Ledger Device Management Kit (DMK) signing operations safely: initialize the SDK, establish a device session, verify device state, open the correct chain app, perform signing or device management operations, and return the result. Use when a developer needs to implement a signing operation (transaction, message, typed data), derive or retrieve an address from a Ledger device, send any command to a Ledger device, or perform device management operations such as genuine check, app install, or app uninstall.

Software Development

Konflux Architecture

9

konflux-ci/agent-plugins

Use when needing to understand Konflux architecture, design decisions, service responsibilities, APIs, build/test/release workflows, or how Konflux components fit together.

Software Development18

Dmk Intent Vocabulary

9

LedgerHQ/agent-skills

Map developer intent and natural language to the correct Ledger Device Management Kit (DMK) components, operations, and API methods. Use when a developer's request is phrased informally, incompletely, or in terms of outcomes rather than API methods, when the intent is ambiguous and needs mapping to a specific DMK component or operation, or when a developer asks 'how do I...', 'what's the difference between...', or describes a symptom rather than an API.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.