[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75MTB91SB6HPB3ZRT20F950":3,"skill-same:01M75MTB91SB6HPB3ZRT20F950":59},{"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":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M75MTB91SB6HPB3ZRT20F950","electrodb",null,"Use when defining DynamoDB entities, modeling indexes, or writing queries\u002Fmutations with the ElectroDB ORM. Covers entity schema, access patterns, CRUD operations, update expressions, and single-table design patterns.","whimzyLive\u002Fnightshift-ai","whimzyLive","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22066605?v=4","01M75MMH22XX6R3NTAFHD7HEN7","Rushi Patel","01M75MMH32DHVVC61XRSHWVEV2",3,"MIT","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Felectrodb\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: electrodb\ndescription: Use when defining DynamoDB entities, modeling indexes, or writing queries\u002Fmutations with the ElectroDB ORM. Covers entity schema, access patterns, CRUD operations, update expressions, and single-table design patterns.\n---\n\n# ElectroDB\n\nTypeScript-first DynamoDB ORM. Manages composite key composition, enforces attribute types, and generates safe DocumentClient params. No raw `DynamoDBClient` calls.\n\n## Installation\n\n```bash\nnpm install electrodb @aws-sdk\u002Fclient-dynamodb @aws-sdk\u002Flib-dynamodb\n```\n\n## Entity Definition\n\n```typescript\nimport { DynamoDBClient } from \"@aws-sdk\u002Fclient-dynamodb\";\nimport { DynamoDBDocumentClient } from \"@aws-sdk\u002Flib-dynamodb\";\nimport { Entity } from \"electrodb\";\n\nconst client = DynamoDBDocumentClient.from(new DynamoDBClient({}));\n\nconst Task = new Entity(\n  {\n    model: {\n      entity: \"task\",      \u002F\u002F item type namespace\n      service: \"taskapp\",  \u002F\u002F application namespace\n      version: \"1\",\n    },\n    attributes: {\n      taskId:      { type: \"string\", required: true, default: () => crypto.randomUUID() },\n      projectId:   { type: \"string\", required: true },\n      employeeId:  { type: \"string\", required: true },\n      status:      { type: [\"pending\", \"active\", \"done\"] as const, required: true },\n      description: { type: \"string\" },\n      ttl:         { type: \"number\" },  \u002F\u002F epoch seconds for DynamoDB TTL\n      createdAt:   { type: \"string\", readOnly: true, default: () => new Date().toISOString() },\n      updatedAt:   { type: \"string\", watch: \"*\", set: () => new Date().toISOString() },\n    },\n    indexes: {\n      \u002F\u002F Table index (no `index` property = primary table index)\n      primary: {\n        pk: { field: \"pk\", composite: [\"taskId\"] },\n        sk: { field: \"sk\", composite: [\"projectId\"] },\n      },\n      \u002F\u002F GSI — reference by logical name, not DynamoDB index name\n      byProject: {\n        index: \"gsi1pk-gsi1sk-index\",\n        pk: { field: \"gsi1pk\", composite: [\"projectId\"] },\n        sk: { field: \"gsi1sk\", composite: [\"employeeId\", \"taskId\"] },\n      },\n    },\n  },\n  { table: process.env.TABLE_NAME!, client },\n);\n```\n\n## Schema Quick Reference\n\n### Attribute options\n\n| Option | Description |\n|--------|-------------|\n| `type` | `\"string\"` `\"number\"` `\"boolean\"` `\"list\"` `\"map\"` `\"set\"` or enum array `[\"a\",\"b\"]` |\n| `required` | Throw on put\u002Fcreate if missing |\n| `default` | Static value or `() => value` factory |\n| `readOnly` | Cannot be changed after creation |\n| `watch: \"*\"` | Re-run `set` on every update (useful for `updatedAt`) |\n| `validate` | Regex or `(val) => boolean` |\n\n### model fields\n\n| Field | Purpose |\n|-------|---------|\n| `model.entity` | Namespaces items on the table; prevents cross-entity key collisions |\n| `model.service` | Groups entities into a Service for cross-entity queries |\n| `model.version` | Bumping changes key format — migrate existing items first |\n\n## Index Design\n\n```typescript\nindexes: {\n  \u002F\u002F Primary (table index) — no `index` property\n  primary: {\n    pk: { field: \"pk\", composite: [\"tenantId\"] },\n    sk: { field: \"sk\", composite: [\"entityId\", \"createdAt\"] },\n  },\n  \u002F\u002F GSI\n  byStatus: {\n    index: \"gsi1pk-gsi1sk-index\",\n    pk: { field: \"gsi1pk\", composite: [\"tenantId\", \"status\"] },\n    sk: { field: \"gsi1sk\", composite: [\"createdAt\"] },\n  },\n  \u002F\u002F LSI (same pk field as table index)\n  byDate: {\n    index: \"lsi1-index\",\n    pk: { field: \"pk\", composite: [\"tenantId\"] },\n    sk: { field: \"lsi1sk\", composite: [\"createdAt\"] },\n  },\n}\n```\n\n**Key composition rule:** composite array order is hierarchical — you can query on a prefix but not skip attributes. `[\"a\",\"b\",\"c\"]` supports queries on `a` or `a+b` or `a+b+c`, never `b` alone.\n\n## CRUD Operations\n\nAll operations are lazy — chain methods build the expression, then call `.go()` to execute or `.params()` to inspect the raw DocumentClient params.\n\n### put (full overwrite)\n\n```typescript\nconst { data } = await Task.put({\n  taskId: \"t-001\",\n  projectId: \"proj-x\",\n  employeeId: \"emp-42\",\n  status: \"pending\",\n}).go();\n```\n\n### create (fails if item exists)\n\n```typescript\nawait Task.create({ taskId, projectId, employeeId, status: \"pending\" }).go();\n```\n\n### get\n\n```typescript\nconst { data } = await Task.get({ taskId: \"t-001\", projectId: \"proj-x\" }).go();\n\u002F\u002F data is null if not found\n```\n\n### delete\n\n```typescript\nawait Task.delete({ taskId: \"t-001\", projectId: \"proj-x\" }).go();\n```\n\n### update\n\n```typescript\n\u002F\u002F Chain operations\nawait Task.update({ taskId, projectId })\n  .set({ status: \"active\", description: \"started\" })\n  .go();\n\n\u002F\u002F data() for type-safe complex updates\nawait Task.update({ taskId, projectId })\n  .data((a, o) => {\n    o.set(a.status, \"done\");\n    o.remove(a.description);\n    o.add(a.retryCount, 1);           \u002F\u002F increment number\n    o.append(a.log, [\"step complete\"]); \u002F\u002F append to list\n  })\n  .go();\n```\n\n### patch (update + fails if item missing)\n\n```typescript\nawait Task.patch({ taskId, projectId }).set({ status: \"done\" }).go();\n```\n\n## Queries\n\n```typescript\n\u002F\u002F By primary index — pk composite only\nconst { data } = await Task.query.primary({ taskId: \"t-001\" }).go();\n\n\u002F\u002F By GSI — filter sk with begins\u002Fbetween\u002Fgte\u002Flte\nconst { data } = await Task.query.byProject({ projectId: \"proj-x\" })\n  .begins({ employeeId: \"emp-\" })\n  .go();\n\n\u002F\u002F Sort descending, limit, paginate\nconst { data, cursor } = await Task.query.byProject({ projectId: \"proj-x\" })\n  .go({ order: \"desc\", limit: 20 });\n\n\u002F\u002F Next page\nconst { data: page2 } = await Task.query.byProject({ projectId: \"proj-x\" })\n  .go({ cursor });\n```\n\n### Sort key operations\n\n| Method | DynamoDB equivalent |\n|--------|-------------------|\n| `.begins({ sk: \"val\" })` | `begins_with` |\n| `.between({ sk: \"a\" }, { sk: \"z\" })` | `BETWEEN` |\n| `.gte({ sk: \"val\" })` | `>= val` |\n| `.gt({ sk: \"val\" })` | `> val` |\n| `.lte({ sk: \"val\" })` | `\u003C= val` |\n| `.lt({ sk: \"val\" })` | `\u003C val` |\n\n### Filter (post-query)\n\n```typescript\nconst { data } = await Task.query.byProject({ projectId })\n  .where((attr, op) => op.eq(attr.status, \"pending\"))\n  .go();\n\n\u002F\u002F Multiple conditions\n  .where((attr, op) => `${op.eq(attr.status, \"pending\")} AND ${op.gt(attr.ttl, 0)}`)\n```\n\n## Conditional Writes\n\n```typescript\n\u002F\u002F Conditional update — fail if condition not met\nawait Task.update({ taskId, projectId })\n  .set({ status: \"done\" })\n  .where((attr, op) => op.eq(attr.status, \"active\"))\n  .go();\n```\n\n## Execution Options\n\n```typescript\n\u002F\u002F Inspect params without executing\nconst params = Task.get({ taskId, projectId }).params();\n\n\u002F\u002F Override table at runtime\nawait Task.get({ taskId, projectId }).go({ table: \"other-table\" });\n\n\u002F\u002F Include pk\u002Fsk in response (stripped by default)\nawait Task.get({ taskId, projectId }).go({ data: \"includeKeys\" });\n\n\u002F\u002F Consistent read\nawait Task.get({ taskId, projectId }).go({ consistent: true });\n\n\u002F\u002F Project specific attributes\nawait Task.get({ taskId, projectId }).go({ attributes: [\"status\", \"createdAt\"] });\n```\n\n## Single-Table Design Patterns\n\n**One table, generic key names** — ElectroDB namespaces items by `model.entity` automatically. Items from different entities on the same table never collide.\n\n**TTL** — declare as `{ type: \"number\" }` attribute, enable TTL on the field in DynamoDB console\u002FCDK. Set epoch-seconds value at write time.\n\n```typescript\nconst ttl = Math.floor(Date.now() \u002F 1000) + 60 * 60 * 24 * 7; \u002F\u002F 7 days\nawait Task.put({ ...attrs, ttl }).go();\n```\n\n**Service** — group multiple Entity objects for cross-entity queries:\n\n```typescript\nimport { Service } from \"electrodb\";\nconst AppService = new Service({ Task, Employee });\n\u002F\u002F AppService.collections.\u003CcollectionName>(...).go()\n```\n\n## Common Mistakes\n\n| Mistake | Fix |\n|---------|-----|\n| Querying a partial composite pk | All pk composites required; sk composites are optional prefix |\n| Using `update` on non-existent item | Use `patch` to get `ConditionalCheckFailed` or `upsert` |\n| Forgetting `.go()` | Expressions are lazy — nothing executes without `.go()` |\n| Raw `DynamoDBClient` for DynamoDB ops | Always use entity methods; raw client bypasses type safety |\n| Bumping `model.version` without migration | Changes key format — old items become invisible |\n| `set` on a `readOnly` attribute | Throws at runtime; set defaults only via `default` |\n\n## Additional resources\n\n- `scripts\u002Fnew-entity.sh \u003CEntityName>` — scaffolds `src\u002Fentities\u002F\u003Centity-name>.entity.ts` with a ready-to-edit `new Entity({...})` skeleton (model namespace, `createdAt`\u002F`updatedAt`\u002F`ttl` attributes, a primary `pk`\u002F`sk` composite index, and one GSI). Derives a kebab-case filename and a PascalCase export from the argument, and never overwrites an existing file. Use it to start a new entity instead of hand-copying the boilerplate above.\n","# ElectroDB\n\nTypeScript-first DynamoDB ORM. Manages composite key composition, enforces attribute types, and generates safe DocumentClient params. No raw `DynamoDBClient` calls.\n\n## Installation\n\n```bash\nnpm install electrodb @aws-sdk\u002Fclient-dynamodb @aws-sdk\u002Flib-dynamodb\n```\n\n## Entity Definition\n\n```typescript\nimport { DynamoDBClient } from \"@aws-sdk\u002Fclient-dynamodb\";\nimport { DynamoDBDocumentClient } from \"@aws-sdk\u002Flib-dynamodb\";\nimport { Entity } from \"electrodb\";\n\nconst client = DynamoDBDocumentClient.from(new DynamoDBClient({}));\n\nconst Task = new Entity(\n  {\n    model: {\n      entity: \"task\",      \u002F\u002F item type namespace\n      service: \"taskapp\",  \u002F\u002F application namespace\n      version: \"1\",\n    },\n    attributes: {\n      taskId:      { type: \"string\", required: true, default: () => crypto.randomUUID() },\n      projectId:   { type: \"string\", required: true },\n      employeeId:  { type: \"string\", required: true },\n      status:      { type: [\"pending\", \"active\", \"done\"] as const, required: true },\n      description: { type: \"string\" },\n      ttl:         { type: \"number\" },  \u002F\u002F epoch seconds for DynamoDB TTL\n      createdAt:   { type: \"string\", readOnly: true, default: () => new Date().toISOString() },\n      updatedAt:   { type: \"string\", watch: \"*\", set: () => new Date().toISOString() },\n    },\n    indexes: {\n      \u002F\u002F Table index (no `index` property = primary table index)\n      primary: {\n        pk: { field: \"pk\", composite: [\"taskId\"] },\n        sk: { field: \"sk\", composite: [\"projectId\"] },\n      },\n      \u002F\u002F GSI — reference by logical name, not DynamoDB index name\n      byProject: {\n        index: \"gsi1pk-gsi1sk-index\",\n        pk: { field: \"gsi1pk\", composite: [\"projectId\"] },\n        sk: { field: \"gsi1sk\", composite: [\"employeeId\", \"taskId\"] },\n      },\n    },\n  },\n  { table: process.env.TABLE_NAME!, client },\n);\n```\n\n## Schema Quick Reference\n\n### Attribute options\n\n| Option | Description |\n|--------|-------------|\n| `type` | `\"string\"` `\"number\"` `\"boolean\"` `\"list\"` `\"map\"` `\"set\"` or enum array `[\"a\",\"b\"]` |\n| `required` | Throw on put\u002Fcreate if missing |\n| `default` | Static value or `() => value` factory |\n| `readOnly` | Cannot be changed after creation |\n| `watch: \"*\"` | Re-run `set` on every update (useful for `updatedAt`) |\n| `validate` | Regex or `(val) => boolean` |\n\n### model fields\n\n| Field | Purpose |\n|-------|---------|\n| `model.entity` | Namespaces items on the table; prevents cross-entity key collisions |\n| `model.service` | Groups entities into a Service for cross-entity queries |\n| `model.version` | Bumping changes key format — migrate existing items first |\n\n## Index Design\n\n```typescript\nindexes: {\n  \u002F\u002F Primary (table index) — no `index` property\n  primary: {\n    pk: { field: \"pk\", composite: [\"tenantId\"] },\n    sk: { field: \"sk\", composite: [\"entityId\", \"createdAt\"] },\n  },\n  \u002F\u002F GSI\n  byStatus: {\n    index: \"gsi1pk-gsi1sk-index\",\n    pk: { field: \"gsi1pk\", composite: [\"tenantId\", \"status\"] },\n    sk: { field: \"gsi1sk\", composite: [\"createdAt\"] },\n  },\n  \u002F\u002F LSI (same pk field as table index)\n  byDate: {\n    index: \"lsi1-index\",\n    pk: { field: \"pk\", composite: [\"tenantId\"] },\n    sk: { field: \"lsi1sk\", composite: [\"createdAt\"] },\n  },\n}\n```\n\n**Key composition rule:** composite array order is hierarchical — you can query on a prefix but not skip attributes. `[\"a\",\"b\",\"c\"]` supports queries on `a` or `a+b` or `a+b+c`, never `b` alone.\n\n## CRUD Operations\n\nAll operations are lazy — chain methods build the expression, then call `.go()` to execute or `.params()` to inspect the raw DocumentClient params.\n\n### put (full overwrite)\n\n```typescript\nconst { data } = await Task.put({\n  taskId: \"t-001\",\n  projectId: \"proj-x\",\n  employeeId: \"emp-42\",\n  status: \"pending\",\n}).go();\n```\n\n### create (fails if item exists)\n\n```typescript\nawait Task.create({ taskId, projectId, employeeId, status: \"pending\" }).go();\n```\n\n### get\n\n```typescript\nconst { data } = await Task.get({ taskId: \"t-001\", projectId: \"proj-x\" }).go();\n\u002F\u002F data is null if not found\n```\n\n### delete\n\n```typescript\nawait Task.delete({ taskId: \"t-001\", projectId: \"proj-x\" }).go();\n```\n\n### update\n\n```typescript\n\u002F\u002F Chain operations\nawait Task.update({ taskId, projectId })\n  .set({ status: \"active\", description: \"started\" })\n  .go();\n\n\u002F\u002F data() for type-safe complex updates\nawait Task.update({ taskId, projectId })\n  .data((a, o) => {\n    o.set(a.status, \"done\");\n    o.remove(a.description);\n    o.add(a.retryCount, 1);           \u002F\u002F increment number\n    o.append(a.log, [\"step complete\"]); \u002F\u002F append to list\n  })\n  .go();\n```\n\n### patch (update + fails if item missing)\n\n```typescript\nawait Task.patch({ taskId, projectId }).set({ status: \"done\" }).go();\n```\n\n## Queries\n\n```typescript\n\u002F\u002F By primary index — pk composite only\nconst { data } = await Task.query.primary({ taskId: \"t-001\" }).go();\n\n\u002F\u002F By GSI — filter sk with begins\u002Fbetween\u002Fgte\u002Flte\nconst { data } = await Task.query.byProject({ projectId: \"proj-x\" })\n  .begins({ employeeId: \"emp-\" })\n  .go();\n\n\u002F\u002F Sort descending, limit, paginate\nconst { data, cursor } = await Task.query.byProject({ projectId: \"proj-x\" })\n  .go({ order: \"desc\", limit: 20 });\n\n\u002F\u002F Next page\nconst { data: page2 } = await Task.query.byProject({ projectId: \"proj-x\" })\n  .go({ cursor });\n```\n\n### Sort key operations\n\n| Method | DynamoDB equivalent |\n|--------|-------------------|\n| `.begins({ sk: \"val\" })` | `begins_with` |\n| `.between({ sk: \"a\" }, { sk: \"z\" })` | `BETWEEN` |\n| `.gte({ sk: \"val\" })` | `>= val` |\n| `.gt({ sk: \"val\" })` | `> val` |\n| `.lte({ sk: \"val\" })` | `\u003C= val` |\n| `.lt({ sk: \"val\" })` | `\u003C val` |\n\n### Filter (post-query)\n\n```typescript\nconst { data } = await Task.query.byProject({ projectId })\n  .where((attr, op) => op.eq(attr.status, \"pending\"))\n  .go();\n\n\u002F\u002F Multiple conditions\n  .where((attr, op) => `${op.eq(attr.status, \"pending\")} AND ${op.gt(attr.ttl, 0)}`)\n```\n\n## Conditional Writes\n\n```typescript\n\u002F\u002F Conditional update — fail if condition not met\nawait Task.update({ taskId, projectId })\n  .set({ status: \"done\" })\n  .where((attr, op) => op.eq(attr.status, \"active\"))\n  .go();\n```\n\n## Execution Options\n\n```typescript\n\u002F\u002F Inspect params without executing\nconst params = Task.get({ taskId, projectId }).params();\n\n\u002F\u002F Override table at runtime\nawait Task.get({ taskId, projectId }).go({ table: \"other-table\" });\n\n\u002F\u002F Include pk\u002Fsk in response (stripped by default)\nawait Task.get({ taskId, projectId }).go({ data: \"includeKeys\" });\n\n\u002F\u002F Consistent read\nawait Task.get({ taskId, projectId }).go({ consistent: true });\n\n\u002F\u002F Project specific attributes\nawait Task.get({ taskId, projectId }).go({ attributes: [\"status\", \"createdAt\"] });\n```\n\n## Single-Table Design Patterns\n\n**One table, generic key names** — ElectroDB namespaces items by `model.entity` automatically. Items from different entities on the same table never collide.\n\n**TTL** — declare as `{ type: \"number\" }` attribute, enable TTL on the field in DynamoDB console\u002FCDK. Set epoch-seconds value at write time.\n\n```typescript\nconst ttl = Math.floor(Date.now() \u002F 1000) + 60 * 60 * 24 * 7; \u002F\u002F 7 days\nawait Task.put({ ...attrs, ttl }).go();\n```\n\n**Service** — group multiple Entity objects for cross-entity queries:\n\n```typescript\nimport { Service } from \"electrodb\";\nconst AppService = new Service({ Task, Employee });\n\u002F\u002F AppService.collections.\u003CcollectionName>(...).go()\n```\n\n## Common Mistakes\n\n| Mistake | Fix |\n|---------|-----|\n| Querying a partial composite pk | All pk composites required; sk composites are optional prefix |\n| Using `update` on non-existent item | Use `patch` to get `ConditionalCheckFailed` or `upsert` |\n| Forgetting `.go()` | Expressions are lazy — nothing executes without `.go()` |\n| Raw `DynamoDBClient` for DynamoDB ops | Always use entity methods; raw client bypasses type safety |\n| Bumping `model.version` without migration | Changes key format — old items become invisible |\n| `set` on a `readOnly` attribute | Throws at runtime; set defaults only via `default` |\n\n## Additional resources\n\n- `scripts\u002Fnew-entity.sh \u003CEntityName>` — scaffolds `src\u002Fentities\u002F\u003Centity-name>.entity.ts` with a ready-to-edit `new Entity({...})` skeleton (model namespace, `createdAt`\u002F`updatedAt`\u002F`ttl` attributes, a primary `pk`\u002F`sk` composite index, and one GSI). Derives a kebab-case filename and a PascalCase export from the argument, and never overwrites an existing file. Use it to start a new entity instead of hand-copying the boilerplate above.\n",{"name":5,"description":7},"main","7d4ebd573a4218d5e92eced411b259f34e9203fe","skills\u002Felectrodb",0,"https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai","https:\u002F\u002Fwithnightshift.com\u002F","https:\u002F\u002Fgithub.com\u002FwhimzyLive","Creator of @typedorm","2026-11-14 22:45:42",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add whimzyLive\u002Fnightshift-ai --skill electrodb",{"tool":39,"command":40},"bunx","bunx skills add whimzyLive\u002Fnightshift-ai --skill electrodb",{"tool":42,"command":43},"pnpm","pnpm dlx skills add whimzyLive\u002Fnightshift-ai --skill electrodb","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Felectrodb\u002FSKILL.md",true,[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"evals\u002Fevals.json","REFERENCE","参考文档",3032,"https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Felectrodb\u002Fevals\u002Fevals.json",{"path":54,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":57,"sourceHtmlUrl":58},"scripts\u002Fnew-entity.sh","SCRIPT","脚本",3851,"https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Felectrodb\u002Fscripts\u002Fnew-entity.sh",[60,68,75,82,89,96],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":67},"01M7BCEWYHDS1FWAJ6G4CD9P54","designing-in-patterns","Use when designing, planning or auditing UI against a component library — naming surfaces with the repo's pattern vocabulary, deciding reuse versus extend versus new, exploring compositions, or writing the reuse table (component-plan.md, a spec's `## Reuse`, a UI audit). Carries the design method; the repo's own vocabulary, bundle and board rules come from project-context and the designer override.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fplugins\u002Fsdlc\u002Fskills\u002Fdesigning-in-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M75MVN6GACAC87SV9RBPBMKH","typeorm","Use when defining TypeORM entities, writing migrations, or building repository\u002Fquery-builder code in TypeScript. Covers entity and relation decorators, the Data Mapper pattern, migrations, the query builder, transactions, and multi-database configuration.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Ftypeorm\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M75MTEZV8SAZNS20YDSB7KG2","hono-api","Use when building or extending REST APIs with Hono + @hono\u002Fzod-openapi. Covers schema-first route declaration with createRoute, feature-grouped composable routers, a class-based service layer behind interfaces, the strategy pattern for multi-event webhooks, typed request validation, and auto-generated OpenAPI docs.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Fhono-api\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M75MT7KT9A3XYX38TX5MY6MA","atomic-design","Use when structuring or decomposing any frontend UI into reusable components, regardless of framework. Applies Brad Frost's atomic design methodology — atoms, molecules, organisms, templates, and pages — to guide consistent component hierarchy, naming, and composition decisions.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fskills\u002Fatomic-design\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M75MSTQ54EY0K29PKBF212K1","writing-docs","Use when writing, restructuring, or reviewing any prose documentation — a tutorial, how-to guide, reference page, or explanation\u002Fconceptual doc — for a public docs site (e.g. Mintlify MDX, docs\u002F, README material), a getting-started guide, an API\u002FCLI reference page, or a \"why we built it this way\" conceptual page. Applies the Diátaxis framework (see https:\u002F\u002Fdiataxis.fr\u002F) — every document belongs to exactly one of the four quadrants (tutorial \u002F how-to guide \u002F reference \u002F explanation), and mixing quadrants inside one document is the single most common documentation failure. Covers the four-quadrant compass for picking the right form, per-quadrant structure templates, an anti-pattern list for quadrant drift, and generic voice\u002Fcraft rules — repo-specific voice and target output format (e.g. Mintlify MDX) are resolved from the repo's docs-manifest (falling back to project-context), never hardcoded here.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fplugins\u002Fsdlc\u002Fskills\u002Fwriting-docs\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M75MSM0Z0AHA6YS4Q5E6R65T","writing-adrs","Use when authoring an Architecture Decision Record (ADR) — a short document that captures one significant, hard-to-reverse technical or architectural decision, its context, and its consequences. Triggered by the sdlc ADR pipeline (the knowledge-engineer agent behind \u002Fsdlc:docs seed adr and \u002Fsdlc:docs distill) when generating an ADR from a story, and by anyone hand-authoring an ADR under docs\u002Fadr\u002F today. Covers why ADRs are kept short and inverted-pyramid, the required sections (Title, Status, Decision, Context, Alternatives Considered, Consequences), the proposed→accepted→superseded (or →rejected) status lifecycle and the never-edit-only-supersede immutability rule, the NNNN-decision-slug.md filename convention, and the ADR frontmatter fields (status, agents, source-stories) the pipeline reads to route a generated ADR into docs\u002Fadr\u002Findex.md.","https:\u002F\u002Fgithub.com\u002FwhimzyLive\u002Fnightshift-ai\u002Fblob\u002Fmain\u002Fplugins\u002Fsdlc\u002Fskills\u002Fwriting-adrs\u002FSKILL.md",[],[]]