[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DBK0CW02KSS6PVNDHH0Z9E":3,"skill-same:01M7DBK0CW02KSS6PVNDHH0Z9E":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7DBK0CW02KSS6PVNDHH0Z9E","scaffold-exercises",null,"Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.","msurkovsky\u002Fgist","msurkovsky","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F618135?v=4","01M7DBFZY3C5C90611RG7ZJJAG","Martin Šurkovský","01M7DBFZYQC296ZH4GJTJ54565",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmsurkovsky\u002Fgist\u002Fblob\u002Fmain\u002Fexperimental\u002Fmattpocock\u002Fskills\u002Fmisc\u002Fscaffold-exercises\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: scaffold-exercises\ndescription: Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.\n---\n\n# Scaffold Exercises\n\nCreate exercise directory structures that pass `pnpm ai-hero-cli internal lint`, then commit with `git commit`.\n\n## Directory naming\n\n- **Sections**: `XX-section-name\u002F` inside `exercises\u002F` (e.g., `01-retrieval-skill-building`)\n- **Exercises**: `XX.YY-exercise-name\u002F` inside a section (e.g., `01.03-retrieval-with-bm25`)\n- Section number = `XX`, exercise number = `XX.YY`\n- Names are dash-case (lowercase, hyphens)\n\n## Exercise variants\n\nEach exercise needs at least one of these subfolders:\n\n- `problem\u002F` - student workspace with TODOs\n- `solution\u002F` - reference implementation\n- `explainer\u002F` - conceptual material, no TODOs\n\nWhen stubbing, default to `explainer\u002F` unless the plan specifies otherwise.\n\n## Required files\n\nEach subfolder (`problem\u002F`, `solution\u002F`, `explainer\u002F`) needs a `readme.md` that:\n\n- Is **not empty** (must have real content, even a single title line works)\n- Has no broken links\n\nWhen stubbing, create a minimal readme with a title and a description:\n\n```md\n# Exercise Title\n\nDescription here\n```\n\nIf the subfolder has code, it also needs a `main.ts` (>1 line). But for stubs, a readme-only exercise is fine.\n\n## Workflow\n\n1. **Parse the plan** - extract section names, exercise names, and variant types\n2. **Create directories** - `mkdir -p` for each path\n3. **Create stub readmes** - one `readme.md` per variant folder with a title\n4. **Run lint** - `pnpm ai-hero-cli internal lint` to validate\n5. **Fix any errors** - iterate until lint passes\n\n## Lint rules summary\n\nThe linter (`pnpm ai-hero-cli internal lint`) checks:\n\n- Each exercise has subfolders (`problem\u002F`, `solution\u002F`, `explainer\u002F`)\n- At least one of `problem\u002F`, `explainer\u002F`, or `explainer.1\u002F` exists\n- `readme.md` exists and is non-empty in the primary subfolder\n- No `.gitkeep` files\n- No `speaker-notes.md` files\n- No broken links in readmes\n- No `pnpm run exercise` commands in readmes\n- `main.ts` required per subfolder unless it's readme-only\n\n## Moving\u002Frenaming exercises\n\nWhen renumbering or moving exercises:\n\n1. Use `git mv` (not `mv`) to rename directories - preserves git history\n2. Update the numeric prefix to maintain order\n3. Re-run lint after moves\n\nExample:\n\n```bash\ngit mv exercises\u002F01-retrieval\u002F01.03-embeddings exercises\u002F01-retrieval\u002F01.04-embeddings\n```\n\n## Example: stubbing from a plan\n\nGiven a plan like:\n\n```\nSection 05: Memory Skill Building\n- 05.01 Introduction to Memory\n- 05.02 Short-term Memory (explainer + problem + solution)\n- 05.03 Long-term Memory\n```\n\nCreate:\n\n```bash\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.01-introduction-to-memory\u002Fexplainer\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002F{explainer,problem,solution}\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.03-long-term-memory\u002Fexplainer\n```\n\nThen create readme stubs:\n\n```\nexercises\u002F05-memory-skill-building\u002F05.01-introduction-to-memory\u002Fexplainer\u002Freadme.md -> \"# Introduction to Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fexplainer\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fproblem\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fsolution\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.03-long-term-memory\u002Fexplainer\u002Freadme.md -> \"# Long-term Memory\"\n```\n","# Scaffold Exercises\n\nCreate exercise directory structures that pass `pnpm ai-hero-cli internal lint`, then commit with `git commit`.\n\n## Directory naming\n\n- **Sections**: `XX-section-name\u002F` inside `exercises\u002F` (e.g., `01-retrieval-skill-building`)\n- **Exercises**: `XX.YY-exercise-name\u002F` inside a section (e.g., `01.03-retrieval-with-bm25`)\n- Section number = `XX`, exercise number = `XX.YY`\n- Names are dash-case (lowercase, hyphens)\n\n## Exercise variants\n\nEach exercise needs at least one of these subfolders:\n\n- `problem\u002F` - student workspace with TODOs\n- `solution\u002F` - reference implementation\n- `explainer\u002F` - conceptual material, no TODOs\n\nWhen stubbing, default to `explainer\u002F` unless the plan specifies otherwise.\n\n## Required files\n\nEach subfolder (`problem\u002F`, `solution\u002F`, `explainer\u002F`) needs a `readme.md` that:\n\n- Is **not empty** (must have real content, even a single title line works)\n- Has no broken links\n\nWhen stubbing, create a minimal readme with a title and a description:\n\n```md\n# Exercise Title\n\nDescription here\n```\n\nIf the subfolder has code, it also needs a `main.ts` (>1 line). But for stubs, a readme-only exercise is fine.\n\n## Workflow\n\n1. **Parse the plan** - extract section names, exercise names, and variant types\n2. **Create directories** - `mkdir -p` for each path\n3. **Create stub readmes** - one `readme.md` per variant folder with a title\n4. **Run lint** - `pnpm ai-hero-cli internal lint` to validate\n5. **Fix any errors** - iterate until lint passes\n\n## Lint rules summary\n\nThe linter (`pnpm ai-hero-cli internal lint`) checks:\n\n- Each exercise has subfolders (`problem\u002F`, `solution\u002F`, `explainer\u002F`)\n- At least one of `problem\u002F`, `explainer\u002F`, or `explainer.1\u002F` exists\n- `readme.md` exists and is non-empty in the primary subfolder\n- No `.gitkeep` files\n- No `speaker-notes.md` files\n- No broken links in readmes\n- No `pnpm run exercise` commands in readmes\n- `main.ts` required per subfolder unless it's readme-only\n\n## Moving\u002Frenaming exercises\n\nWhen renumbering or moving exercises:\n\n1. Use `git mv` (not `mv`) to rename directories - preserves git history\n2. Update the numeric prefix to maintain order\n3. Re-run lint after moves\n\nExample:\n\n```bash\ngit mv exercises\u002F01-retrieval\u002F01.03-embeddings exercises\u002F01-retrieval\u002F01.04-embeddings\n```\n\n## Example: stubbing from a plan\n\nGiven a plan like:\n\n```\nSection 05: Memory Skill Building\n- 05.01 Introduction to Memory\n- 05.02 Short-term Memory (explainer + problem + solution)\n- 05.03 Long-term Memory\n```\n\nCreate:\n\n```bash\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.01-introduction-to-memory\u002Fexplainer\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002F{explainer,problem,solution}\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.03-long-term-memory\u002Fexplainer\n```\n\nThen create readme stubs:\n\n```\nexercises\u002F05-memory-skill-building\u002F05.01-introduction-to-memory\u002Fexplainer\u002Freadme.md -> \"# Introduction to Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fexplainer\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fproblem\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fsolution\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.03-long-term-memory\u002Fexplainer\u002Freadme.md -> \"# Long-term Memory\"\n```\n",{"name":5,"description":7},"main","e3e4cfd3ffe30ed9a8ef3479e758aacac9c4636d","experimental\u002Fmattpocock\u002Fskills\u002Fmisc\u002Fscaffold-exercises","https:\u002F\u002Fgithub.com\u002Fmsurkovsky\u002Fgist","https:\u002F\u002Fgithub.com\u002Fmsurkovsky","https:\u002F\u002Fsurkovsky.cz\u002F","2026-10-06 04:56:29",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add msurkovsky\u002Fgist --skill scaffold-exercises",{"tool":37,"command":38},"bunx","bunx skills add msurkovsky\u002Fgist --skill scaffold-exercises",{"tool":40,"command":41},"pnpm","pnpm dlx skills add msurkovsky\u002Fgist --skill scaffold-exercises","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmsurkovsky\u002Fgist\u002Fblob\u002Fmain\u002Fexperimental\u002Fmattpocock\u002Fskills\u002Fmisc\u002Fscaffold-exercises\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",108,"https:\u002F\u002Fgithub.com\u002Fmsurkovsky\u002Fgist\u002Fblob\u002Fmain\u002Fexperimental\u002Fmattpocock\u002Fskills\u002Fmisc\u002Fscaffold-exercises\u002Fagents\u002Fopenai.yaml",[52,59,66,73,80,87],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M7DBM4VPVT6W1GYRBEJ00KMX","gist-outline","Summarize a codebase's file counts, dominant languages, and size when asked for an overview or when unfamiliar-tree orientation helps the requested work.","https:\u002F\u002Fgithub.com\u002Fmsurkovsky\u002Fgist\u002Fblob\u002Fmain\u002Fskills\u002Fgist-outline\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7DBKZCSV1QAQDG6VWF2A2M3","gist-md-review","Let the user review a markdown file in a browser page, commenting on selected text, while you revise it round by round until they approve. Use when the user wants to read and comment on a document themselves, as in \"review docs\u002Fplan.md with me\", \"let me review this doc\", \"I want to comment on the design\", or \"continue the review of docs\u002Fplan.md\". Not for reviewing code, and not when the user asks you to review a document yourself.","https:\u002F\u002Fgithub.com\u002Fmsurkovsky\u002Fgist\u002Fblob\u002Fmain\u002Fskills\u002Fgist-md-review\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7DBKSQF24E7HD7EEVB949F3","gist-doc-review","Review the comments and doc strings in a change — cut the ones restating the code, shorten the bloated ones, add the missing line on public API. Use when asked to \"review the docs\", \"check my comments\", \"am I overdocumenting\", \"doc review\", or before shipping a change that added a lot of prose.","https:\u002F\u002Fgithub.com\u002Fmsurkovsky\u002Fgist\u002Fblob\u002Fmain\u002Fskills\u002Fgist-doc-review\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7DBKNKB340B59SNBZKXPAEF","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Fmsurkovsky\u002Fgist\u002Fblob\u002Fmain\u002Fexperimental\u002Fmattpocock\u002Fskills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7DBKM0QBGKNFN3V7SGAQ9YA","wait-what","Stop. That last message did not land: re-pitch it.","https:\u002F\u002Fgithub.com\u002Fmsurkovsky\u002Fgist\u002Fblob\u002Fmain\u002Fexperimental\u002Fmattpocock\u002Fskills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7DBKHXYJV0Y3MJ7F1SJ098P","to-questionnaire","Turn a decision you can't fully answer into a questionnaire for someone else to fill in.","https:\u002F\u002Fgithub.com\u002Fmsurkovsky\u002Fgist\u002Fblob\u002Fmain\u002Fexperimental\u002Fmattpocock\u002Fskills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[]]