gpsaggese/helpers / .claude/skills/tutorial_in_60_mins.create
tutorial_in_60_mins.create
VerifiedCreate a tutorial directory for the Learn X in 60 Minutes conventions
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.5 KB |
SKILL.md
View on GitHub---
description: Create a tutorial directory for the Learn X in 60 Minutes conventions
model: sonnet
---
# Goal
- You are an expert at structuring self-contained, reproducible data-science
tutorials
- The user passes a `<TOPIC>` and a target dir such as `tutorials/<TOPIC>`
- Write a "Learn XYZ in 60 Minutes" tutorial for the topic / package `<TOPIC>` in
`tutorials/<TOPIC>`
# Workflow
## Read the Specs and Examples
- Read `.claude/skills/tutorial_in_60_mins.rules.md`
## Improve Content of the Tutorial
- Assume the user already created `tutorials/<TOPIC>` following
`.claude/skills/tutorial_in_60_mins.rules.md`
- Files in `tutorials/<TOPIC>` that typically need customization:
- `XYZ_utils.py`: Reusable helper functions (no notebook logic)
- `XYZ.API.ipynb`: Native API walkthrough (paired with XYZ.API.py)
- `XYZ.API.py`: Jupytext percent-format mirror
- `XYZ.example.ipynb`: End-to-end application demo (paired with
XYZ.example.py)
- `XYZ.example.py`: Jupytext percent-format mirror
- `requirements.txt`: Python dependencies (pinned versions)
- `README.md`: Quick start guide
## Improve Docker Build System
- Modify `tutorials/<TOPIC>/docker_name.sh`
```bash
# The file should be all lower case.
IMAGE_NAME=umd_project_<TOPIC>
```
- Modify `tutorials/<TOPIC>/requirements.txt` to include the needed packages
- Customize the Docker build system in `tutorials/<TOPIC>` following
`.claude/skills/docker.use_standard_style/SKILL.md`
## Create Content of the README.md
- Create or improve `tutorials/<TOPIC>/README.md`
- Right after the title, add how the README was generated:
```markdown
- Generated by `.claude/skills/tutorial_in_60_mins.create/SKILL.md`
```
- Use as reference: `tutorials/AutoGen/README.md`, `tutorials/BambooAI/README.md`,
`tutorials/TensorFlow/README.md`
- Run `lint_text.py -i` to format the README
## Run Docker
- Make sure the system builds:
```bash
> cd tutorials/<TOPIC>
> docker_build.sh
```
## Customize the Tests
- Customize the tests in `tutorials/<TOPIC>/test` if needed
- Make sure the tests run:
```bash
> cd tutorials/<TOPIC>
> docker_cmd.sh `pytest test`
```
## Create Blog Entry
- Create or improve `website/docs/blog/posts/<TOPIC>_in_60_mins.md`
- After the front matter, add how the post was generated:
```markdown
<!-- Generated by `.claude/skills/tutorial_in_60_mins.create/SKILL.md` -->
```
- Choose categories from `categories_allowed` in `website/mkdocs.yml` based on
what makes sense, e.g.,
```yaml
categories:
- AI Research
- Software Engineering
```
- Use as a reference:
- `website/docs/blog/posts/in_60_mins.AutoGen.md`,
- `website/docs/blog/posts/in_60_mins.BambooAI.md`,
- `website/docs/blog/posts/in_60_mins.Tensorflow.md`,
- Run `lint_text.py -i` to format the markdown file
# Examples
- Use as a reference of how a tutorial looks
- `tutorials/AutoGen`
- `tutorials/BambooAI`
- `tutorials/TensorFlow`
# Verification
- [ ] `tutorials/<TOPIC>` builds: `docker_build.sh` completes without error
- [ ] Tests pass: `docker_cmd.sh` `pytest test` completes without error
- [ ] `tutorials/<TOPIC>/README.md` exists and was linted with `lint_text.py -i`
- [ ] `website/docs/blog/posts/<TOPIC>_in_60_mins.md` exists, has categories from
`website/mkdocs.yml`, and was linted with `lint_text.py -i`
- [ ] The README says that it was generated by
`.claude/skills/tutorial_in_60_mins.create/SKILL.md`
- [ ] The blog post says that it was generated by
`.claude/skills/tutorial_in_60_mins.create/SKILL.md`
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |