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
Goal
- You are an expert at structuring self-contained, reproducible data-science tutorials
- The user passes a
<TOPIC>and a target dir such astutorials/<TOPIC> - Write a "Learn XYZ in 60 Minutes" tutorial for the topic / package
<TOPIC>intutorials/<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 mirrorXYZ.example.ipynb: End-to-end application demo (paired with XYZ.example.py)XYZ.example.py: Jupytext percent-format mirrorrequirements.txt: Python dependencies (pinned versions)README.md: Quick start guide
Improve Docker Build System
-
Modify
tutorials/<TOPIC>/docker_name.sh# The file should be all lower case. IMAGE_NAME=umd_project_<TOPIC> -
Modify
tutorials/<TOPIC>/requirements.txtto 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:
- 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 -ito format the README
Run Docker
- Make sure the system builds:
> cd tutorials/<TOPIC> > docker_build.sh
Customize the Tests
- Customize the tests in
tutorials/<TOPIC>/testif needed - Make sure the tests run:
> 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:
<!-- Generated by `.claude/skills/tutorial_in_60_mins.create/SKILL.md` --> - Choose categories from
categories_allowedinwebsite/mkdocs.ymlbased on what makes sense, e.g.,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 -ito format the markdown file
Examples
- Use as a reference of how a tutorial looks
tutorials/AutoGentutorials/BambooAItutorials/TensorFlow
Verification
-
tutorials/<TOPIC>builds:docker_build.shcompletes without error - Tests pass:
docker_cmd.shpytest testcompletes without error -
tutorials/<TOPIC>/README.mdexists and was linted withlint_text.py -i -
website/docs/blog/posts/<TOPIC>_in_60_mins.mdexists, has categories fromwebsite/mkdocs.yml, and was linted withlint_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: 196k | 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: 192k | 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: 192k | 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: 192k | Updated | Claude CodeCodex | Verified | Install |