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

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

    # 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:
    - 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:
    > cd tutorials/<TOPIC>
    > docker_build.sh
    

Customize the Tests

  • Customize the tests in tutorials/<TOPIC>/test if 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_allowed in website/mkdocs.yml based 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 -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: 196kUpdated 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: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated 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: 192kUpdated Claude CodeCodexVerifiedInstall