Skip to content

gpsaggese/helpers / .claude/skills/slides.add_tutorial_links

slides.add_tutorial_links

Verified

Link lecture slides to matching sections of a rendered tutorial notebook

FileKindSize
SKILL.mdskill md1.7 KB
---
description: Link lecture slides to matching sections of a rendered tutorial notebook
model: sonnet
---

# Goal
- Given a slides file `<SMD_FILE>` and a rendered HTML tutorial `<TUTORIAL_URL>`,
  add links from each slide to the tutorial section it corresponds to

  - E.g., `<SMD_FILE>` =
    `msml610/lectures_source/Lesson09.3-Multi_Armed_Bandits.txt` and
    `<TUTORIAL_URL>` =
    `https://raw.githack.com/gpsaggese/gpsaggese.github.io/gp_scratch/msml610/tutorials/L09_multi_armed_bandits/L09_03_02_multi_armed_bandits.html`

# Workflow

## Find the Relationship
- Read `<SMD_FILE>` and `<TUTORIAL_URL>`
- If a companion tutorial markdown exists next to the notebook (e.g.,
  `<TUTORIAL_DIR>/<TUTORIAL_NAME>.md`), use it to match slides to tutorial cells
- Match each slide to the tutorial cell(s) that cover the same concept

## Add Links
- For each match, add a link in the slide to the tutorial anchor for that
  cell
  - The anchor is the rendered HTML's cell heading, e.g.
    `<TUTORIAL_URL>#Cell-1:-Introduction---Casino-Slot-Machines`
- Do not add a link when no tutorial cell clearly corresponds to the slide

## Leave Structure and Content Unchanged
- Do not change the structure of the text (titles, bullet hierarchy, div fenced
  blocks) or the substantive content: add only the link

# Conventions
- Follow the role specified in `.claude/skills/role.ai_researcher.md`
- Follow the conventions in `.claude/skills/slides.rules.md`

# Verification
- [ ] Check that each added anchor points to an actual heading in
  `<TUTORIAL_URL>`, not a guessed slug
- [ ] Make sure that the updated slides render correctly, e.g.,
  ```bash
  > gen_slides.py -i <FILE> --notes_to_pdf_args="--skip_action open_pdf"
  ```
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall