[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75DBHFVBX7ZM9JFPY4KYAB8":3,"skill-same:01M75DBHFVBX7ZM9JFPY4KYAB8":43},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M75DBHFVBX7ZM9JFPY4KYAB8","add-component",null,"Use when adding or substantially modifying any UI component in this repo — before writing the first line of JSX.","nathaniel-lyman\u002Fparts-bin","nathaniel-lyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F212639847?v=4","01M75DAXV0KPY2T75ERWJ6HW10","01M75DAXVND673PXPXAQ863WHJ",0,"MIT","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002Fskills\u002Fadd-component\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: add-component\ndescription: Use when adding or substantially modifying any UI component in this repo — before writing the first line of JSX.\n---\n\n# Add a Component\n\n## Overview\n\nThis repo has ~99 cataloged components; the most common failure is building\none that already exists or styling it outside the theme boundary. The\nworkflow is catalog-first, token-only, catalog-registered.\n\n## Checklist\n\n1. **Search before you build: read `src\u002Fcomponents\u002Fcatalog.ts`.** It's the\n   machine-readable index — import path, `purpose`, `use_when`,\n   `prefer_over` (which near-twin to pick and why), real props, and a\n   snippet. `\u002Fdocs` renders it live in the running app. If a near-twin\n   exists, extend it instead of adding a sibling.\n2. **Style with tokens only.** Token-backed Tailwind utilities\n   (`bg-surface`, `text-ink`, `border-line`, `text-accent`,\n   `text-pos\u002Fneg\u002Fwarn`, `bg-accent-soft`, …) and the `.num` \u002F `.micro` \u002F\n   `.display` helper classes. `var(--token)` references are fine — that's\n   how `Sparkline` and the charts get color. Never raw colors\n   (`npm run lint:theme` blocks them) and never named Tailwind colors like\n   `bg-black\u002F40` (the linter misses those, but they break re-skinning).\n   Need a new color? Add\u002Fderive a token in `src\u002Ftheme\u002Ftokens.css` first.\n3. **Export from the right barrel** (`ui`, `shell`, `charts`, `DataGrid`, or\n   the `src\u002Fcomponents` aggregate) — consumers import from barrels, not deep\n   paths.\n4. **Register it in `CATALOG`** (`src\u002Fcomponents\u002Fcatalog.ts`) via the\n   `defineComponent` factory — the `props` array is compile-checked against\n   the component's real props, so `npm run build` fails on typos. Fill\n   `purpose`, `use_when`, a copy-paste `snippet`, and `prefer_over` if it\n   has near-twins. Helper components not meant for direct use go in the\n   `INTERNAL` map instead (name → one-line reason).\n   `src\u002Fcomponents\u002Fcatalog.test.ts` fails if any export is neither\n   cataloged nor `INTERNAL`, if an `INTERNAL` entry goes stale, or if\n   `prefer_over`\u002F`related` reference uncataloged names.\n5. **Colocate a test** as `ComponentName.test.tsx` next to the source.\n6. **Verify the smallest affected surface:** run the component's colocated\n   test first. If you changed exports, catalog metadata, or public props, also\n   run `npx vitest run src\u002Fcomponents\u002Fcatalog.test.ts src\u002Fcomponents\u002Fbarrels.test.ts`\n   and `npm run build` because the catalog `props` check only runs in the build\n   gate, not in Vitest. If you only changed internal rendering or styling, do\n   not run the full repo gauntlet unless the change is cross-cutting or the\n   user asks for it.\n\n## Common mistakes\n\n| Mistake | Fix |\n|---|---|\n| Built a twin of an existing component | Check `use_when`\u002F`prefer_over` in the catalog first |\n| Hardcoded a hex \"temporarily\" | Add a token; lint:theme fails the build regardless |\n| `bg-white`, `bg-black\u002F40`, `text-gray-500` | Invisible to lint:theme but wrong — use `bg-surface`, `text-muted`, … |\n| Skipped the CATALOG entry | `catalog.test.ts` fails; intentional helpers go in `INTERNAL` |\n| Internal component test passed, but public props changed | `defineComponent` props are checked by `tsc`, so run `npm run build` |\n","# Add a Component\n\n## Overview\n\nThis repo has ~99 cataloged components; the most common failure is building\none that already exists or styling it outside the theme boundary. The\nworkflow is catalog-first, token-only, catalog-registered.\n\n## Checklist\n\n1. **Search before you build: read `src\u002Fcomponents\u002Fcatalog.ts`.** It's the\n   machine-readable index — import path, `purpose`, `use_when`,\n   `prefer_over` (which near-twin to pick and why), real props, and a\n   snippet. `\u002Fdocs` renders it live in the running app. If a near-twin\n   exists, extend it instead of adding a sibling.\n2. **Style with tokens only.** Token-backed Tailwind utilities\n   (`bg-surface`, `text-ink`, `border-line`, `text-accent`,\n   `text-pos\u002Fneg\u002Fwarn`, `bg-accent-soft`, …) and the `.num` \u002F `.micro` \u002F\n   `.display` helper classes. `var(--token)` references are fine — that's\n   how `Sparkline` and the charts get color. Never raw colors\n   (`npm run lint:theme` blocks them) and never named Tailwind colors like\n   `bg-black\u002F40` (the linter misses those, but they break re-skinning).\n   Need a new color? Add\u002Fderive a token in `src\u002Ftheme\u002Ftokens.css` first.\n3. **Export from the right barrel** (`ui`, `shell`, `charts`, `DataGrid`, or\n   the `src\u002Fcomponents` aggregate) — consumers import from barrels, not deep\n   paths.\n4. **Register it in `CATALOG`** (`src\u002Fcomponents\u002Fcatalog.ts`) via the\n   `defineComponent` factory — the `props` array is compile-checked against\n   the component's real props, so `npm run build` fails on typos. Fill\n   `purpose`, `use_when`, a copy-paste `snippet`, and `prefer_over` if it\n   has near-twins. Helper components not meant for direct use go in the\n   `INTERNAL` map instead (name → one-line reason).\n   `src\u002Fcomponents\u002Fcatalog.test.ts` fails if any export is neither\n   cataloged nor `INTERNAL`, if an `INTERNAL` entry goes stale, or if\n   `prefer_over`\u002F`related` reference uncataloged names.\n5. **Colocate a test** as `ComponentName.test.tsx` next to the source.\n6. **Verify the smallest affected surface:** run the component's colocated\n   test first. If you changed exports, catalog metadata, or public props, also\n   run `npx vitest run src\u002Fcomponents\u002Fcatalog.test.ts src\u002Fcomponents\u002Fbarrels.test.ts`\n   and `npm run build` because the catalog `props` check only runs in the build\n   gate, not in Vitest. If you only changed internal rendering or styling, do\n   not run the full repo gauntlet unless the change is cross-cutting or the\n   user asks for it.\n\n## Common mistakes\n\n| Mistake | Fix |\n|---|---|\n| Built a twin of an existing component | Check `use_when`\u002F`prefer_over` in the catalog first |\n| Hardcoded a hex \"temporarily\" | Add a token; lint:theme fails the build regardless |\n| `bg-white`, `bg-black\u002F40`, `text-gray-500` | Invisible to lint:theme but wrong — use `bg-surface`, `text-muted`, … |\n| Skipped the CATALOG entry | `catalog.test.ts` fails; intentional helpers go in `INTERNAL` |\n| Internal component test passed, but public props changed | `defineComponent` props are checked by `tsc`, so run `npm run build` |\n",{"name":5,"description":7},"main","5dd5fff030a1246374fe1c4b57210cfc13732f9e","skills\u002Fadd-component","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman","2026-10-29 18:49:15",{"source":8,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add nathaniel-lyman\u002Fparts-bin --skill add-component",{"tool":35,"command":36},"bunx","bunx skills add nathaniel-lyman\u002Fparts-bin --skill add-component",{"tool":38,"command":39},"pnpm","pnpm dlx skills add nathaniel-lyman\u002Fparts-bin --skill add-component","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002Fskills\u002Fadd-component\u002FSKILL.md",true,[],[44,51,58,65,70,75],{"skillNo":45,"name":46,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":18},"01M75DBRTKD0EWS59Z2QY9Z19M","verify-changes","Use before claiming any change to this repo is done, fixed, or passing — and when a build fails after tests passed, a color sneaks past lint, or a localStorage test misbehaves.","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002Fskills\u002Fverify-changes\u002FSKILL.md",[],[],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M75DBPNE1XBCTD5XPJDBQ6D4","swap-data-domain","Use when replacing the demo accounts\u002FMRR data with your own domain — new entity types, seed data, KPIs, chart series, grid columns, or CRUD forms.","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002Fskills\u002Fswap-data-domain\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":18},"01M75DBKPNENC9H1MYXN2Y7PBT","retheme","Use when re-skinning this dashboard to a new brand or palette — changing colors, accent, dark mode, radii, fonts, or chart colors, or when asked to \"make it match my brand\".","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002Fskills\u002Fretheme\u002FSKILL.md",[],[],{"skillNo":66,"name":46,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M75DBEKJRMF50NX8GB4494S6","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fverify-changes\u002FSKILL.md",[],[],{"skillNo":71,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M75DBBYPQ61R4R337F30FCZ9","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fswap-data-domain\u002FSKILL.md",[],[],{"skillNo":76,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M75DBA6DGYN01RTY28K712BN","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fretheme\u002FSKILL.md",[],[]]