Skip to content

gpsaggese/helpers / .claude/skills/tutorial_in_60_mins.create

tutorial_in_60_mins.create

Verified

Create a tutorial directory for the Learn X in 60 Minutes conventions

FileKindSize
SKILL.mdskill md3.5 KB
---
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`
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall