Agent skill

Workshop

by brevdev in brevdev/workshop-build-an-agent

This skill should be used when a learner wants to navigate or understand the Build-an-Agent workshop as a whole — e.g.

Apache-2.0Auto-check passedEducation

Install Workshop

skills CLI
$ npx skills add brevdev/workshop-build-an-agent --skill workshop -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install brevdev/workshop-build-an-agent workshop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/brevdev/workshop-build-an-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/workshop .claude/skills/workshop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
workshop
GitHub stars
143
Token cost
~1.4k tokens
SKILL.md length
654 words
Files
6 (incl. references)
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

This skill should be used when a learner wants to navigate or understand the Build-an-Agent workshop as a whole — e.g.

  • Tasks that involve Building AI agents
  • SKILL.md covers The seven-module arc, How to route a request, Shared resources (the hub the… and Tutoring stance (applies here…, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Tutoring and explanations

What it does

Workshop is an agent skill from brevdev/workshop-build-an-agent. This skill should be used when a learner wants to navigate or understand the Build-an-Agent workshop as a whole — e.g. "/workshop where do I start?", "what order should I do the modules in?", "what does Module 3 need before I start?", "which module covers RAG / evaluation / training / safety?", "how do the modules connect?", "what's the difference between MCP, Skills, and deep-agent skills across modules?", "what have I finished and what's next?", "am I ready for the next module?". It is the workshop's overview +…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/connections.md`, `references/glossary.md` and `references/map.md`).

It sits in Education, covering Building AI agents, Tutoring and explanations and Retrieval-augmented generation. It works with Model Context Protocol. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Building AI agents
  • Tasks that involve Tutoring and explanations
  • Tasks that involve Retrieval-augmented generation

Example prompts

  • “/workshop where do I start?”
  • “what order should I do the modules in?”
  • “what does Module 3 need before I start?”
  • “/workshop”

Requirements

  • Docker

What it can do on your machine

Read from SKILL.md and the folder at commit b5689a7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Workshop loads about 1.4k tokens when it runs, and up to ~9.1k if it reads all its reference files. Until then it costs about 212 tokens; SKILL.md has 654 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~212
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from brevdev/workshop-build-an-agent at commit b5689a7, republished under its Apache-2.0 licence (© brevdev). 654 words, ~1,436 tokens.

Download SKILL.mdSave it as .claude/skills/workshop/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
workshop
description
This skill should be used when a learner wants to navigate or understand the Build-an-Agent workshop as a whole — e.g. "/workshop where do I start?", "what order should I do the modules in?", "what does Module 3 need before I start?", "which module covers RAG / evaluation / training / safety?", "how do the modules connect?", "what's the difference between MCP, Skills, and deep-agent skills across modules?", "what have I finished and what's next?", "am I ready for the next module?". It is the workshop's overview + router that maps the seven-module arc and prerequisites, points the learner to the right /module-N skill, explains cross-module connections, and hosts the shared tutoring policy, glossary, and progress checks that all module skills draw on. For installing/launching the environment it points to the setup-workshop skill.
user-invocable
true
disable-model-invocation
false

Build-an-Agent Workshop — Guide & Router

The entry point and map for the Build-an-Agent workshop. Use this to orient a learner, route them to the right module skill, explain how the modules connect, and answer "where am I / what's next / is my environment ready?" — without doing their work for them.

This skill is the hub: each /module-N skill handles its own module in depth; this skill handles the whole journey and hosts the resources shared across all of them.

Invoking the tutor: the learner reaches these skills by running claude (in a DevX-Lab JupyterLab terminal, or against a local clone) and typing /workshop for this overview or /module-N (1–7) for a specific module; setup is in the README's Learn with an AI tutor section. Meta-note worth surfacing when relevant: these very skills are the open Agent Skills format the learner builds in Module 7.

The learner asked: $ARGUMENTS

The seven-module arc

Each module adds a capability and a matching discipline. Detailed version in references/map.md.

#ModuleWhat you buildSkillNeeds first~TimeHardware
1Build an Agenta ReAct report-generation agent/module-1— (start here)1–2 hnone (cloud)
2Agentic RAGan IT help-desk RAG agent (+ MCP + Skills)/module-2M1 concepts2–3 hnone main path (opt. GPU)
3Agent Evaluationan eval pipeline (RAGAS + LLM-judge)/module-3M1 + M2 agents built2–3 hnone (cloud)
4Agent Customizationa GRPO-trained LangGraph-CLI agent/module-4M1–M3 concepts3–4 hGPU required
5Deep Agentsa sandboxed deep agent/module-5M1–M2 concepts1–2 hDocker (no GPU)
6Agent Safetya NemoClaw-hardened OpenClaw agent/module-6M4–M5 concepts; extends M32–2.5 hDocker + Landlock enabled
7Harnesses & Skillsa pi-style harness + portable skills/module-7M1–M62–3 hnone main; opt. GPU (Ex4)

Hard prerequisite: Module 3 evaluates the M1 and M2 agents, so those must be built first (the M3 lesson lets the learner copy the M2 answer key to get a runnable agent-under-test; as tutor you still never open or paste it). The other modules are conceptually sequential but each is independently runnable.

How to route a request

Map the learner's intent to the right skill, then hand off (or invoke it):

  • "what is an agent / ReAct / tools / system prompt" → module-1
  • "RAG, embeddings, reranking, MCP, agent skills, langgraph dev" → module-2
  • "evaluate, RAGAS, faithfulness, LLM-as-judge, metrics, datasets" → module-3
  • "train, fine-tune, GRPO, synthetic data, reward, GPU/OOM" → module-4
  • "deep agent, planning, sub-agents, sandboxing, deepagents" → module-5
  • "safety, NemoClaw, OpenShell, Landlock, Privacy Router, red-team" → module-6
  • "harness, context tax, lazy skills, pi/Hermes/Claude Code, Verified Skills, GPU skills" → module-7
  • "install / set up / spin up the workshop, can't open DevX-Lab" → the setup-workshop skill
  • overview / order / prerequisites / "how do X and Y connect" / "what's next" → stay here
Show full SKILL.md (211 more words)Show less

Shared resources (the hub the module skills point back to)

  • references/map.md — detailed per-module map: concepts, code locations, time, hardware, the /module-N skill.
  • references/connections.md — how concepts thread across modules (the agent core, the tools→skills line, the model thread, the safety arc, the eval thread, the NVIDIA-tech thread). For cross-module synthesis questions.
  • references/glossary.md — shared definitions for terms that recur across modules. For "what does X mean?" regardless of module.
  • references/tutor-policy.md — the canonical tutoring policy all module skills follow, plus the "Check my work" and "Orientation / progress" protocols. Read when unsure how to behave as a tutor.
  • references/progress.md — read-only state checks per module ("what have I finished / what's broken / am I ready for the next module?").

Tutoring stance (applies here too)

You are a learning assistant, not an answer key. Explain, route, and orient; never complete a learner's exercises, and never open or paste solutions/answer keys (check attempts against the Targets in each module's references/exercises.md); give graduated hints; don't spoil a module the learner hasn't reached. Full policy + rationale in references/tutor-policy.md.

Environment

To get the workshop running (install NVIDIA AI Workbench, build, launch DevX-Lab, or reach it from Claude Code), use the setup-workshop skill. For "is my hardware compatible with module N?", see that module's Environment & hardware section, or the hardware column in references/map.md.

© brevdev, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in .claude/skills/workshop of brevdev/workshop-build-an-agent.

  • SKILL.md
  • references/connections.md
  • references/glossary.md
  • references/map.md
  • references/progress.md
  • references/tutor-policy.md

Open the folder on GitHubat commit b5689a7

Compare with similar skills

Workshop next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Workshop compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workshop this skillbrevdev/workshop-build-an-agent143—~1.4kAutomated safety check: PassApache-2.0
SynalinksSynaLinks/synalinks-skills907—~4.8kAutomated safety check: PassApache-2.0
Agent Squad for TypeScript2FastLabs/agent-squad7.8k—~4.3kAutomated safety check: PassApache-2.0
AI Engineering Course Guiderohitg00/ai-engineering-from-scratch65k—~1.7kAutomated safety check: PassMIT
Dive Into LangGraphluochang212/dive-into-langgraph457—~837Automated safety check: NotesCustom licence
Penshotneopen/story-shot-agent213—~547Automated safety check: NotesMIT

Similar skills

  • Synalinks

    SynaLinks/synalinks-skills

    A skill your agent uses for anything involving the Synalinks neuro-symbolic LM framework (Keras-inspired): DataModel/Field/Input, JSON operators (+ & | ^ ~), synalinks.ops…

    907 GitHub stars~4.8k tokensUpdated 9 days ago
    AI & LLM EngineeringAuto-check passed
  • Agent Squad for TypeScript

    2FastLabs/agent-squad

    Guide to building Node.js and TypeScript apps on the agent-squad package: orchestrator, agent types, classifier routing, storage, retrievers and MCP tools.

    7.8k GitHub stars~4.3k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • AI Engineering Course Guide

    rohitg00/ai-engineering-from-scratch

    Routes a topic, question or bug to the exact lessons in the AI Engineering from Scratch curriculum and suggests the next command to run.

    65k GitHub stars~1.7k tokensUpdated yesterday
    EducationAuto-check passed
  • Dive Into LangGraph

    luochang212/dive-into-langgraph

    A Chinese-language guide and reference for building agents with LangGraph 1.0, from a first ReAct agent through middleware, memory, MCP, RAG and web search.

    457 GitHub stars~837 tokensUpdated 26 days ago
    AI & LLM EngineeringAuto-check: notes
  • Penshot

    neopen/story-shot-agent

    PenShot 项目开发 Skill。用于修改或审查 Agent、LangGraph 工作流、任务生命周期、记忆/RAG、配置、REST、MCP、CLI、测试和项目文档;先核实源码与工具配置,再按现有架构实施并验证。

    213 GitHub stars~547 tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check: notes
  • Learn

    fancyboi999/ai-engineering-from-scratch-zh

    AI Engineering from Scratch 课程的交互式课程 tutor。读取 LEARNING.md,获取下一课, 在终端按章节教学,结尾测验并记录进度。可在克隆仓库中或完全通过 raw.githubusercontent.com 工作—— 无需设置。触发短语:“下一课”、“教我”、“继续课程”、“我们来学习”、“继续学习”,或 "next lesson", "teach…

    1.2k GitHub stars~1.1k tokensUpdated 9 days ago
    EducationAuto-check passed

More from brevdev/workshop-build-an-agent

All 11 skills in this repo
  • Setup Workshop

    brevdev/workshop-build-an-agent

    This skill should be used when the user wants to set up, install, deploy, bootstrap, or "spin up" the Build-an-Agent workshop (a.k.a.

    143 GitHub stars~2.3k tokensUpdated today
    Auto-check: notes
  • Setup Workshop Nemoclaw

    brevdev/workshop-build-an-agent

    Set up the NVIDIA "Build an Agent" DevX workshop as a working JupyterLab environment from INSIDE a locked-down OpenShell/NemoClaw sandbox, and hand the user the token URL + access commands.

    143 GitHub stars~5.2k tokensUpdated today
    Auto-check passed
  • Nvwb

    brevdev/workshop-build-an-agent

    Manage NVIDIA AI Workbench projects, contexts, builds, and environments via the nvwb CLI.

    143 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Module 1

    brevdev/workshop-build-an-agent

    This skill should be used when a learner is working through Module 1 ("Build an Agent") of the Build-an-Agent workshop and wants help understanding the concepts, notebooks, or code — e.g.

    143 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Module 1

    brevdev/workshop-build-an-agent

    This skill should be used when a learner is working through Module 1 ("Build an Agent") of the Build-an-Agent workshop and wants help understanding the concepts, notebooks, or code — e.g.

    143 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Workshop

    brevdev/workshop-build-an-agent

    This skill should be used when a learner wants to navigate or understand the Build-an-Agent workshop as a whole — e.g.

    143 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Questions about Workshop

What does Workshop do?

This skill should be used when a learner wants to navigate or understand the Build-an-Agent workshop as a whole — e.g. Workshop is an agent skill from brevdev/workshop-build-an-agent.g.

When should I use Workshop?

Workshop fits situations like: tasks that involve Building AI agents; tasks that involve Tutoring and explanations; tasks that involve Retrieval-augmented generation.

How do I install Workshop in Claude Code?

Run `npx skills add brevdev/workshop-build-an-agent --skill workshop -a claude-code`. Or copy the skill folder (.claude/skills/workshop in brevdev/workshop-build-an-agent) into .claude/skills/workshop in your project. Claude Code loads it when a task matches its description.

How do I install Workshop in Codex?

Run `npx skills add brevdev/workshop-build-an-agent --skill workshop -a codex`. Or copy the skill folder (.claude/skills/workshop in brevdev/workshop-build-an-agent) into .agents/skills/workshop in your project. Codex loads it when a task matches its description.

Can I use Workshop in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add brevdev/workshop-build-an-agent --skill workshop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workshop, .gemini/skills/workshop, .github/skills/workshop and .opencode/skills/workshop in your project.

What does Workshop need to run?

SKILL.md names no scripts, command-line tools or credentials: Workshop is instructions for the agent only. Our summary lists: Docker.

Does Workshop access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Workshop safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Workshop use?

Workshop is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workshop use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.7k tokens, read only when the agent opens those files.

What are the alternatives to Workshop?

Skills that share tags, products or a category with Workshop: Synalinks (SynaLinks/synalinks-skills, 907 stars), Agent Squad for TypeScript (2FastLabs/agent-squad, 7.8k stars), AI Engineering Course Guide (rohitg00/ai-engineering-from-scratch, 65k stars) and Dive Into LangGraph (luochang212/dive-into-langgraph, 457 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workshop?

brevdev (a GitHub organization) maintains it in brevdev/workshop-build-an-agent, which has 143 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 6, 2026.

Source: brevdev/workshop-build-an-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.