Releases: JAICHANGPARK/workshop-harness
Release list
v2026.08.26 - 17 Skills Suite, Google ADK Multi-Agent Builder, ELI5 Explainer, Gemini 3.7 & Live
What's Changed in v2026.08.26
🚀 Key Highlights & New Capabilities
-
17th Agent Skill:
eli5-concept-explainer:- Translates complex AI mechanics, model architectures, and runtime error signatures into 3-tier ELI5 (Explain Like I'm 5) physical analogies, visual Mermaid mental maps, and beginner cheat sheets.
- Equips facilitators and TAs with 10-second live Q&A crisis scripts to eliminate cognitive overload for novice attendees.
-
16th Agent Skill:
adk-workshop-builder:- Builds multi-language (Python, TypeScript, Go, Kotlin) autonomous agent & multi-agent system workshops using Google Agent Development Kit (ADK).
- Standardizes Coordinator-Worker delegation, custom tool bindings, Human-in-the-Loop (HITL) checkpoints, and trajectory evaluation.
- Generates language-specific starter vs final solutions (
package.json,go.mod,build.gradle.kts,pyproject.toml).
-
Gemini 3.7 Flash & Google GenAI SDK Support:
- Integrated
gemini-3.7-flashas the primary flagship workhorse model for coding and agentic tasks. - Added support for dynamic thinking budget control (
thinking_config/thinkingLevel). - Standardized on unified
google-genaiPython and@google/genaiJavaScript/TypeScript SDKs.
- Integrated
-
Gemini Live API & Real-Time Multimodal Streaming:
- Added full support for
gemini-3.1-flash-live-preview(low-latency voice/audio/video) andgemini-3.5-live-translate-preview. - Added pub.dev
gemini_liveFlutter package integration (zero Firebase dependency, direct WebSocket streaming). - Added 3-step Gemini Live real-time curriculum track to
hands-on-curriculum-builder.
- Added full support for
-
Next-Gen Model Specifications:
- Added Anthropic Claude Generation 5 (
claude-sonnet-5,claude-opus-5,claude-fable-5). - Added OpenAI GPT-5.6 series (
gpt-5.6-sol,gpt-5.6-terra,gpt-5.6-luna).
- Added Anthropic Claude Generation 5 (
-
17 Agent Skills Metadata & Localization Sync:
- Synchronized 17 skills metadata across
docs/,README.md,CLAUDE.md,AGENTS.md, andwebsite/app.js(EN, KO, JA, ZH).
- Synchronized 17 skills metadata across
v2026.08.16 — Google Colab CLI, Marp Slide Generator & 15 Agent Skills
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog.
[v2026.08.16] - 2026-08-16
Added
- 14th Agent Skill:
colab-workshop-integrator:- Automatically transforms workshop labs and starter/final code into interactive Google Colab Jupyter Notebooks (
.ipynb). - Injects zero-setup cells: automated
%pip install, GPU accelerator verification (!nvidia-smi), and Colab Secrets credential handling (google.colab.userdata). - Generates 'Open in Colab' SVG badges and Colab README documentation.
- Integrates with official Google Colab CLI (
colab-cli) for automated headless cloud execution and smoke testing.
- Automatically transforms workshop labs and starter/final code into interactive Google Colab Jupyter Notebooks (
- 15th Agent Skill:
workshop-slide-generator:- Generates publication-ready presentation slide decks in Marp Markdown (
output/slides/slides.md) and standalone zero-dependency interactive Web Presentations (output/slides/index.html). - Syncs 1:1 with facilitator timeline markers in
RUNBOOK.md. - Supports instant PDF/PPTX compilation via Marp CLI.
- Generates publication-ready presentation slide decks in Marp Markdown (
- CLI Commands (
harness_cli.py):- Added
build-slidescommand with--target,--output, and--export-pdfflags. - Added
export-colabcommand with--target,--output,--repo, and--testflags. - Added
test-colabcommand for one-click Colab CLI verification. - Updated
generate-allpipeline to full 8-step orchestrator across all 15 skills.
- Added
- Documentation & Agent Standards:
- Expanded
AGENTS.md, multi-language READMEs (EN, KR, JA, ZH), and MkDocs documentation to 15 specialized skills.
- Expanded
[v2026.08.01] - 2026-08-01
Changed
- Full English Localization:
- Fully translated all 12
SKILL.mdinstruction files to English to ensure global AI agent compatibility across Claude Code, Aider, Cursor, Codex, and Antigravity. - Translated all core document templates in
templates/doc-templates/(Hardware & Env, Prerequisites, Session Guide, Prompt Pack, Troubleshooting FAQ, Facilitator Runbook, FAQ Generator, Persona Loop Review) to English. - Updated python scripts (
generate_prep_pdf.py,verify_workshop.py) andharness_cli.pydocstrings and generated template strings to English.
- Fully translated all 12
[v2026.07.30] - 2026-07-30
Added
-
12 Specialized Agent Skills for end-to-end workshop automation:
workshop-scaffolder: Standard repository structure scaffoldingcross-architecture-checker: Apple Silicon, Intel Mac, Windows, Linux compatibility audit & fallback matrixprerequisite-checker: OS-specific SDK/language installation guides, Google AI Studio & GCP Vertex AI API Key issuance steps, and automatedcheck_env.sh/ps1verification scriptshands-on-curriculum-builder: Step-by-step lab curriculum, starter vs final code, prompt packs with mandatory references protocolpdf-handout-generator: ReportLab + PyMuPDF based PDF handout builder with contact sheet previewworkshop-troubleshooter: RAM-tier (8G/16G/32G+) and OS-specific troubleshooting matrixworkshop-runbook-generator: Minute-by-minute facilitator & TA timeline runbook (RUNBOOK.md)live-debug-assistant: 10-second terminal error hotfix diagnosis & API Key security protocolworkshop-faq-generator: Attendee FAQ auto-generation for hardware, network, and code questionsworkshop-tester: Code execution smoke tests & markdown broken relative link auditorworkshop-web-researcher: Live web search for latest tool/SDK/AI model release tags & breaking change preventionworkshop-persona-loop-evaluator: Loop Engineering multi-persona review for beginner, intermediate, and advanced attendees
-
CLI Automation Tool (
harness_cli.py):generate-all: One-Click Full Orchestrator triggering all 12 skills in sequenceinit: Workshop project scaffolding with templates, scripts, and directory structureaudit-compat: Cross-architecture tech stack risk auditingaudit-loop: Loop Engineering multi-persona evaluationtest: Code smoke tests & markdown link integrity verificationbuild-pdf: Publication-ready PDF handout generation
-
Astral uv Integration:
pyproject.tomlfor declarative dependency management- Auto-install of
reportlab,pymupdf,pillowviauvon first run - All CLI commands support
uv run harness_cli.pyexecution
-
Open AI Agent Standard:
AGENTS.mdadopting the open agents.md specification for vendor-agnostic agent interoperabilityCLAUDE.mdfor Anthropic Claude Code CLI users
-
Dynamic AI Model Discovery Protocol:
- Prevents legacy model hardcoding (
gpt-3.5,llama-2,gemma-1) via mandatory web search verification - Timestamped currency labels on all generated documentation
- Prevents legacy model hardcoding (
-
Google AI Studio & GCP Vertex AI Key Issuance Guide:
- Step-by-step Gemini API Key issuance via AI Studio
- GCP Service Account JSON key generation for Vertex AI
.env.sampleand.gitignoresecurity enforcement
-
Mandatory References Protocol:
- All generated documents include
Referencessection with official documentation URLs and source citations
- All generated documents include
-
Multilingual README Support:
README.md(English, primary)README_KR.md(Korean)README_JA.md(Japanese)README_ZH.md(Chinese)
-
Repository Banner Image (
assets/workshop_harness_banner.jpg) -
Document & Script Templates (8 doc templates, 10+ script templates)
-
Example Project (
examples/one-click-demo-workshop/)
References
v2026.08.01 - Full English Localization
Workshop Harness v2026.08.01
Highlights
- Full English Localization:
- Translated all 12
SKILL.mdagent skills to English for seamless interoperability across international AI coding agents (Claude Code, Cursor, Aider, Antigravity, etc.). - Translated core workshop document templates in
templates/doc-templates/to English. - Standardized CLI scripts and docstrings to English.
- Translated all 12
Full Changelog
See CHANGELOG.md
v2026.07.30 - Initial Release
Workshop Harness v2026.07.30
Highlights
- 12 Specialized Agent Skills for end-to-end workshop automation
- One-Click Full Orchestrator (
generate-all) triggering all 12 skills in sequence - Astral uv Integration with
pyproject.tomland auto-dependency installation - Open AI Agent Standard via
AGENTS.md(agents.md) &CLAUDE.md - Dynamic AI Model Discovery Protocol preventing legacy model hardcoding
- Google AI Studio & GCP Vertex AI Key Issuance Guide in prerequisites
- Loop Engineering Multi-Persona Evaluator for beginner, intermediate, and advanced attendees
- Mandatory References Protocol for all generated documentation
- Multilingual README (English, Korean, Japanese, Chinese)
12 Agent Skills
| # | Skill | Role |
|---|---|---|
| 1 | workshop-scaffolder |
Standard repo structure scaffolding |
| 2 | cross-architecture-checker |
Apple Silicon, Intel Mac, Win, Linux compatibility audit |
| 3 | prerequisite-checker |
OS-specific SDK/API Key installation guide |
| 4 | hands-on-curriculum-builder |
Step-by-step lab curriculum & prompt packs |
| 5 | pdf-handout-generator |
PDF handout builder via ReportLab |
| 6 | workshop-troubleshooter |
RAM-tier & OS troubleshooting matrix |
| 7 | workshop-runbook-generator |
Facilitator & TA timeline runbook |
| 8 | live-debug-assistant |
10-second terminal error hotfix |
| 9 | workshop-faq-generator |
Attendee FAQ auto-generation |
| 10 | workshop-tester |
Code smoke tests & broken link auditor |
| 11 | workshop-web-researcher |
Latest tool/SDK/AI model version verification |
| 12 | workshop-persona-loop-evaluator |
Loop Engineering multi-persona review |
Quick Start
git clone https://github.com/JAICHANGPARK/workshop-harness.git
cd workshop-harness
./scripts/install_skills.sh
uv run harness_cli.py generate-all --name "my-workshop" --topic "Local RAG with Gemma 4" --stack "python,ollama,docker"Full Changelog
See CHANGELOG.md