Appendix: workshop files

Use the public agent-skills workshop repo when you want to compare your local files with the workshop version.

Top-level files

The top-level files in the workshop repo:

• README.md - the original workshop guide and main outline.
• notebook.ipynb - the notebook implementation used for the walkthrough.
• gh-fetch-skill.md - the Claude Code demo skill for fetching files from GitHub.

Example skills

The workshop example skills are:

• skills/hello/SKILL.md - greeting behavior.
• skills/joke/SKILL.md - joke behavior.
• skills/counter/SKILL.md - numbered-list behavior.
• skills/coding_standards/SKILL.md - code-standard instructions with scripts and templates.
• skills/deploy_app/SKILL.md - deployment instructions with @ file references.

Extra files used by skills:

• skills/coding_standards/templates/function_template.md
• skills/coding_standards/scripts/check_standards.sh
• skills/deploy_app/scripts/deploy.sh
• skills/deploy_app/scripts/status.sh
• skills/deploy_app/templates/verification.md

Prototype files

The prototype package:

prototype/
|-- Makefile
|-- README.md
|-- pyproject.toml
|-- uv.lock
|-- commands/
|   |-- review.md
|   `-- test.md
|-- skills/
|   |-- coding_standards/
|   |-- counter/
|   |-- deploy_app/
|   |-- hello/
|   `-- joke/
|-- src/
|   |-- __init__.py
|   |-- agent.py
|   |-- commands.py
|   |-- main.py
|   |-- skill_tool.py
|   |-- skills.py
|   `-- tools.py
`-- tests/
    |-- test_agent_run.py
    |-- test_agent_with_commands.py
    |-- test_agent_with_skills.py
    |-- test_commands.py
    |-- test_skills.py
    `-- utils.py

Workshop pages

The numbered pages:

• README.md - index, links, architecture diagram, and walkthrough links.
• 01-overview.md - prerequisites and environment setup.
• 02-github-fetch-demo.md - Claude Code demo with gh-fetch.
• 03-agent-tools-recap.md - agent loop and coding tools recap.
• 04-general-purpose-runner.md - base ToyAIKit runner.
• 05-skill-markdown-and-examples.md - skill format and example skills.
• 06-parse-and-load-skills.md - notebook loader and prototype file-reference resolution.
• 07-expose-skills-to-agent.md - skill tool and skill-list injection.
• 08-slash-commands.md - command markdown, loader, tool, and /kid run.
• 09-prototype-and-tests.md - importable prototype implementation and tests.
• 10-qa.md - Q&A.
• 11-deferred-items.md - follow-up items and production concerns.
• 12-appendix.md - this file list.