[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79ZVC6V67P0NKW2ESTHTKSR":3,"skill-same:01M79ZVC6V67P0NKW2ESTHTKSR":71},{"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":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M79ZVC6V67P0NKW2ESTHTKSR","generating-readme",null,"Use when generating, rewriting, or refreshing README.md for this loadout repository; when the Available loadouts catalog may be stale after loadout YAML changes; or when testing the loadout README generator against another cloned public repository. Triggers include README.md, loadout catalog, Available loadouts, and the docs\u002Fassets\u002Floadout-banner.jpg banner.","sazlin\u002Floadout","sazlin","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F7120031?v=4","01M79ZSNX5RMXATQTSH5NGHN51","Sean Azlin","01M79ZSNXQ5HCTYC1RE7J5CAPF",0,"MIT","https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fgenerating-readme\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: generating-readme\ndescription: >-\n  Use when generating, rewriting, or refreshing README.md for this loadout\n  repository; when the Available loadouts catalog may be stale after loadout\n  YAML changes; or when testing the loadout README generator against another\n  cloned public repository. Triggers include README.md, loadout catalog,\n  Available loadouts, and the docs\u002Fassets\u002Floadout-banner.jpg banner.\n---\n\n# Generating README\n\nRepo-local skill for this loadout source tree. **Do not add it to any\nloadout YAML.** It is not consumer tooling.\n\n**Core principle:** Prose follows\n[references\u002Freadme-best-practices.md](references\u002Freadme-best-practices.md).\nThe loadout catalog is generated. Hand-editing generated rows is a bug.\n\n## When to use\n\n- Creating or refreshing this repo's `README.md`\n- A loadout YAML was added, removed, renamed, or its artifacts changed\n- User asks to generate a README with this skill (including a test clone)\n\n**Skip:** Unrelated docs and changelogs. Do not vendor this\nskill into `skills\u002F` or attach it to `loadouts\u002F*.yaml`.\n\n## Workflow (this loadout repo)\n\n1. Read [references\u002Freadme-best-practices.md](references\u002Freadme-best-practices.md).\n2. Start from [templates\u002FREADME.md](templates\u002FREADME.md). Keep the banner\n   `docs\u002Fassets\u002Floadout-banner.jpg` and existing pitch \u002F quick start unless a\n   fact changed.\n3. Run the generator script (fills or drops generated sections). It also\n   replaces `{{VERSION}}` \u002F `{{VERSION_NUMBER}}` with the newest git tag.\n   Do not put `{{VERSION}}` on uvx git URLs; those stay `@main`. Edit pins\n   in the template then regenerate; do not hand-edit README.md uvx lines.\n\n```bash\nuv run python .claude\u002Fskills\u002Fgenerating-readme\u002Fscripts\u002Fgenerate_readme.py \\\n  --repo-root . \\\n  --template .claude\u002Fskills\u002Fgenerating-readme\u002Ftemplates\u002FREADME.md \\\n  --output README.md\n```\n\n4. After the script, only edit **non-generated** prose (gist, warnings,\n   local-dev commands). Do not edit between\n   `\u003C!-- generated:loadouts-catalog:start -->` and\n   `\u003C!-- generated:loadouts-catalog:end -->`. That block starts with\n   `### Loadout files`, a list of names linked to `loadouts\u002F\u003Cname>.yaml`,\n   then the catalog table.\n5. Run `uv run pytest tests\u002Ftest_readme_loadouts.py tests\u002Ftest_generating_readme.py`.\n\n## Other public repos (skill test)\n\nThe loadout template is **not** a generic README skeleton. Do not start a\nforeign clone from `templates\u002FREADME.md`.\n\n1. Inventory the clone: existing `README.md`, license, package manifest,\n   screenshots\u002Fgifs\u002Fsvg demos, install\u002Fpackager docs, benchmarks, man\u002F`-h`\n   output, troubleshooting, contributing. If a visual exists, it stays.\n2. **If `README.md` already exists**, start from that file. Check it against\n   the best-practices spine (visual, why, install that works on a clean\n   machine, usage with sample output, caveats, contributing, license). Fill\n   gaps. Do **not** flatten a README that is already the user manual (demo +\n   install matrix + evidence + footguns). Fold long packager lists into\n   `\u003Cdetails>` only if you must shorten; never delete them.\n3. **If there is no README**, write one from the best-practices spine using\n   only facts in the clone. Not the loadout template.\n4. You may still run `generate_readme.py` with `--repo-root` on the clone\n   **only to inspect\u002Fstrip generated blocks in a copy**. Never pass\n   `--template templates\u002FREADME.md --output \u003Cclone>\u002FREADME.md` — that\n   overwrites a foreign README with loadout identity. No `loadouts\u002F*.yaml`\n   → catalog section stripped. No `docs\u002Fassets\u002Floadout-banner.jpg` → beaver\n   banner stripped. Do not leave loadout-only sections (The Gist,\n   `uvx loadout init\u002Fsync`, Agents, Manifest cheatsheet, Superpowers warning,\n   `LOADOUT_PATH`).\n5. Skip `tests\u002Ftest_readme_loadouts.py` on a foreign clone.\n\n## Banner\n\nThis repository: keep the marked banner block. The script keeps it when\n`docs\u002Fassets\u002Floadout-banner.jpg` exists.\n\nForeign clone: the script drops that block when the image file is absent.\nNever copy `loadout-banner.jpg` into another repo. Keep **that** project's\ndemo\u002Flogo if it has one (`doc\u002Fscreencast.svg`, `logo.svg`, etc.).\n\n## Common mistakes\n\n| Mistake | Fix |\n| --- | --- |\n| Hand-writing the loadout table | Run `generate_readme.py` |\n| Mixing CLI tools into Hooks (or a leftover Etc. column) | Hooks lists only hooks; CLI Tools lists only `cli_tools` names |\n| Adding this skill to `loadouts\u002F*.yaml` | Leave it repo-local under `.claude\u002Fskills\u002F` |\n| Inventing loadouts or install commands | Only YAML, tests, and commands you ran |\n| ToC or 15 badges above the pitch | Title → few badges → one sentence |\n| Copying this banner into another repo | Script strips it when the image file is missing |\n| Flattening a CLI README that is the manual | Keep demo, install matrix, evidence, footguns |\n| Starting a foreign README from the loadout template | Start from that repo's README or the spine, never this template |\n| Absolute `blob\u002Fmain` links to own files | Relative paths |\n\n## Additional resources\n\n- [references\u002Freadme-best-practices.md](references\u002Freadme-best-practices.md)\n- [templates\u002FREADME.md](templates\u002FREADME.md)\n- [scripts\u002Fgenerate_readme.py](scripts\u002Fgenerate_readme.py)\n","# Generating README\n\nRepo-local skill for this loadout source tree. **Do not add it to any\nloadout YAML.** It is not consumer tooling.\n\n**Core principle:** Prose follows\n[references\u002Freadme-best-practices.md](references\u002Freadme-best-practices.md).\nThe loadout catalog is generated. Hand-editing generated rows is a bug.\n\n## When to use\n\n- Creating or refreshing this repo's `README.md`\n- A loadout YAML was added, removed, renamed, or its artifacts changed\n- User asks to generate a README with this skill (including a test clone)\n\n**Skip:** Unrelated docs and changelogs. Do not vendor this\nskill into `skills\u002F` or attach it to `loadouts\u002F*.yaml`.\n\n## Workflow (this loadout repo)\n\n1. Read [references\u002Freadme-best-practices.md](references\u002Freadme-best-practices.md).\n2. Start from [templates\u002FREADME.md](templates\u002FREADME.md). Keep the banner\n   `docs\u002Fassets\u002Floadout-banner.jpg` and existing pitch \u002F quick start unless a\n   fact changed.\n3. Run the generator script (fills or drops generated sections). It also\n   replaces `{{VERSION}}` \u002F `{{VERSION_NUMBER}}` with the newest git tag.\n   Do not put `{{VERSION}}` on uvx git URLs; those stay `@main`. Edit pins\n   in the template then regenerate; do not hand-edit README.md uvx lines.\n\n```bash\nuv run python .claude\u002Fskills\u002Fgenerating-readme\u002Fscripts\u002Fgenerate_readme.py \\\n  --repo-root . \\\n  --template .claude\u002Fskills\u002Fgenerating-readme\u002Ftemplates\u002FREADME.md \\\n  --output README.md\n```\n\n4. After the script, only edit **non-generated** prose (gist, warnings,\n   local-dev commands). Do not edit between\n   `\u003C!-- generated:loadouts-catalog:start -->` and\n   `\u003C!-- generated:loadouts-catalog:end -->`. That block starts with\n   `### Loadout files`, a list of names linked to `loadouts\u002F\u003Cname>.yaml`,\n   then the catalog table.\n5. Run `uv run pytest tests\u002Ftest_readme_loadouts.py tests\u002Ftest_generating_readme.py`.\n\n## Other public repos (skill test)\n\nThe loadout template is **not** a generic README skeleton. Do not start a\nforeign clone from `templates\u002FREADME.md`.\n\n1. Inventory the clone: existing `README.md`, license, package manifest,\n   screenshots\u002Fgifs\u002Fsvg demos, install\u002Fpackager docs, benchmarks, man\u002F`-h`\n   output, troubleshooting, contributing. If a visual exists, it stays.\n2. **If `README.md` already exists**, start from that file. Check it against\n   the best-practices spine (visual, why, install that works on a clean\n   machine, usage with sample output, caveats, contributing, license). Fill\n   gaps. Do **not** flatten a README that is already the user manual (demo +\n   install matrix + evidence + footguns). Fold long packager lists into\n   `\u003Cdetails>` only if you must shorten; never delete them.\n3. **If there is no README**, write one from the best-practices spine using\n   only facts in the clone. Not the loadout template.\n4. You may still run `generate_readme.py` with `--repo-root` on the clone\n   **only to inspect\u002Fstrip generated blocks in a copy**. Never pass\n   `--template templates\u002FREADME.md --output \u003Cclone>\u002FREADME.md` — that\n   overwrites a foreign README with loadout identity. No `loadouts\u002F*.yaml`\n   → catalog section stripped. No `docs\u002Fassets\u002Floadout-banner.jpg` → beaver\n   banner stripped. Do not leave loadout-only sections (The Gist,\n   `uvx loadout init\u002Fsync`, Agents, Manifest cheatsheet, Superpowers warning,\n   `LOADOUT_PATH`).\n5. Skip `tests\u002Ftest_readme_loadouts.py` on a foreign clone.\n\n## Banner\n\nThis repository: keep the marked banner block. The script keeps it when\n`docs\u002Fassets\u002Floadout-banner.jpg` exists.\n\nForeign clone: the script drops that block when the image file is absent.\nNever copy `loadout-banner.jpg` into another repo. Keep **that** project's\ndemo\u002Flogo if it has one (`doc\u002Fscreencast.svg`, `logo.svg`, etc.).\n\n## Common mistakes\n\n| Mistake | Fix |\n| --- | --- |\n| Hand-writing the loadout table | Run `generate_readme.py` |\n| Mixing CLI tools into Hooks (or a leftover Etc. column) | Hooks lists only hooks; CLI Tools lists only `cli_tools` names |\n| Adding this skill to `loadouts\u002F*.yaml` | Leave it repo-local under `.claude\u002Fskills\u002F` |\n| Inventing loadouts or install commands | Only YAML, tests, and commands you ran |\n| ToC or 15 badges above the pitch | Title → few badges → one sentence |\n| Copying this banner into another repo | Script strips it when the image file is missing |\n| Flattening a CLI README that is the manual | Keep demo, install matrix, evidence, footguns |\n| Starting a foreign README from the loadout template | Start from that repo's README or the spine, never this template |\n| Absolute `blob\u002Fmain` links to own files | Relative paths |\n\n## Additional resources\n\n- [references\u002Freadme-best-practices.md](references\u002Freadme-best-practices.md)\n- [templates\u002FREADME.md](templates\u002FREADME.md)\n- [scripts\u002Fgenerate_readme.py](scripts\u002Fgenerate_readme.py)\n",{"name":5,"description":7},"main","f6497b6aafdead5bb7cf244894b930f699a53e46",".claude\u002Fskills\u002Fgenerating-readme",1,"https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout","https:\u002F\u002Fgithub.com\u002Fsazlin","https:\u002F\u002Fseanazlin.com","Principal Engineer & Engineering Leader | AI Infrastructure & Marketplace Systems | Fractional CTO for 0-to-1 Startups","2026-11-14 20:13:46",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add sazlin\u002Floadout --skill generating-readme",{"tool":39,"command":40},"bunx","bunx skills add sazlin\u002Floadout --skill generating-readme",{"tool":42,"command":43},"pnpm","pnpm dlx skills add sazlin\u002Floadout --skill generating-readme","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fgenerating-readme\u002FSKILL.md",true,[47,53,57,61,67],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"evals\u002Fevals.json","REFERENCE","参考文档",2270,"https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fgenerating-readme\u002Fevals\u002Fevals.json",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"evals\u002Ffiles\u002Ftiny-readme.template.md",216,"https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fgenerating-readme\u002Fevals\u002Ffiles\u002Ftiny-readme.template.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Freadme-best-practices.md",6160,"https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fgenerating-readme\u002Freferences\u002Freadme-best-practices.md",{"path":62,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":65,"sourceHtmlUrl":66},"scripts\u002Fgenerate_readme.py","SCRIPT","脚本",9041,"https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fgenerating-readme\u002Fscripts\u002Fgenerate_readme.py",{"path":68,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":69,"sourceHtmlUrl":70},"templates\u002FREADME.md",14638,"https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fgenerating-readme\u002Ftemplates\u002FREADME.md",[72,79,86,93,100,107],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7A06GGYSGA1EA79WNMD8JHJ","demo","Demo skill","https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmini_loadout\u002Fskills\u002Fdemo\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7A06BTSB17JVWZ52Z3DQDYY","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment","https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M7A069Y4ZJZBPP82QJ9KBHTV","writing-plans","Use when you have a spec or requirements for a multi-step task, before touching code","https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M7A0676YNTT61WYZ7241T3RB","verification-before-completion","Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always","https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002Fskills\u002Fverification-before-completion\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":19},"01M7A065AY047VH6JBN19WFAZ9","using-superpowers","Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions","https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002Fskills\u002Fusing-superpowers\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":19},"01M7A062FBQ3VPWZT3BP8DWYKA","using-git-worktrees","Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback","https:\u002F\u002Fgithub.com\u002Fsazlin\u002Floadout\u002Fblob\u002Fmain\u002Fskills\u002Fusing-git-worktrees\u002FSKILL.md",[],[]]