[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C6Z85CDGZ2FWWR86GXQ8JM":3,"skill-same:01M7C6Z85CDGZ2FWWR86GXQ8JM":44},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"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":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M7C6Z85CDGZ2FWWR86GXQ8JM","write-discoverable-code",null,"Rules for writing code that coding agents (and humans) can find and understand through\nplain-text search. Apply whenever writing or renaming code: functions, types, constants,\nfiles, error messages, doc comments.\n\nGrounded in measurement: agents navigate by plain-text search, not by AST or\nlanguage server, so every identifier is a search query and every search miss\ncosts wasted reads.","geoquant\u002F.dotfiles","geoquant","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1237781?v=4","01M7C6Q4102NRM32WXRJBMFHBQ","01M7C6Q41MCWNWKYEGV3H6XMFG",0,"MIT","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Fwrite-discoverable-code\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: write-discoverable-code\ndescription: |\n  Rules for writing code that coding agents (and humans) can find and understand through\n  plain-text search. Apply whenever writing or renaming code: functions, types, constants,\n  files, error messages, doc comments.\n\n  Grounded in measurement: agents navigate by plain-text search, not by AST or\n  language server, so every identifier is a search query and every search miss\n  costs wasted reads.\nlicense: MIT\n---\n\n# Write discoverable code\n\nCoding agents discover code by searching for strings and reading small windows around the\nhits. They have no hover text, no jump-to-definition, and no memory between sessions. These\nrules make code resolvable in one search instead of five.\n\n## 1. Names are search queries\n\n- **Exported symbols get 2–4 word names, at least one of them a domain word.**\n  `diffUserObjects`, not `diff`. `queueEventForDispatch`, not `queue`.\n  Measured on a ~700k-line monorepo: 1-word exported names are globally unique 61% of\n  the time; 3-word names 96%; 4+ words 98%. Three words is the knee of the curve.\n  Use the shortest name that greps uniquely; put the rest in the doc comment.\n- **Give generic verbs their object.** `sanitizeEmailHtml`, not `sanitize`;\n  `validateSmtpConfig`, not `validateConfig`. Qualify only as far as uniqueness\n  requires, then stop.\n- **One definition site per symbol.** Never copy a function between files; move it and\n  delete the original in the same change. Shared helpers get one concept-named home\n  and are imported everywhere else.\n- **Do not rely on the module path to disambiguate a generic name.** The import that\n  disambiguates `users\u002Fdiff.ts` from `orders\u002Fdiff.ts` sits at the top of the file; the\n  search hit is at line 300. Put the context in the symbol (`formatDurationMs`), not the\n  folder. Exception: rigid, absolute conventions where the path carries the meaning\n  (e.g. every contract file exporting `Input`\u002F`Output`).\n- **One concept, one spelling.** Pick `organizationId` or `orgId` and use it everywhere;\n  every synonym splits every future search in half. Reuse existing vocabulary in the\n  codebase you are editing rather than introducing near-synonyms.\n- **When behavior or audience changes, rename in the same commit.** A stale name is\n  misinformation with a 100% open rate — that includes visibility markers: a `_private`\n  helper that other modules now import needs a public name.\n- **Filenames are names too — never use bare-role filenames.** `config.ts`, `types.ts`,\n  `utils.ts`, `helpers.ts`, `handlers.ts` say nothing in a search result and collide with\n  every other module's config\u002Ftypes\u002Futils in the repo. Prefix the domain:\n  `billing-plan-config.ts`, not `config.ts`. (`index.ts` is acceptable only as a\n  thin re-export entry point.)\n\n## 2. Types are the documentation agents can't skip\n\n- **Brand your primitive IDs.** `z.string().brand\u003C'UserId'>()` (TS) or newtypes (Rust).\n  A `transferOwnership(userId: string, orgId: string)` signature makes argument\n  transposition invisible; branded types make it a compile error that names the concepts.\n- **Use capability-token parameter types** for privileged operations (e.g. requiring an\n  `OrgScopedDb` instead of a raw connection). A comment is a request; a required type is\n  physics.\n- **Model state with discriminated unions**, not clusters of nullable fields with implicit\n  rules.\n- **Name types like they'll be quoted back** — they will be, in compiler errors the agent\n  uses to self-correct. `OrgScopedDb` explains itself; `Ctx2` does not. Avoid `any`: every\n  `any` is a spot where the compiler goes silent and the agent is back to guessing.\n\n## 3. Say it where the search lands\n\n- **One-line doc comment on every export**, stating the sharpest constraint the code\n  itself can't show (units, timezone, \"source time, not insert time\", ownership).\n  The definition is where a name search lands; that line is your whole message.\n- **Write the plain-words phrase in the doc comment.** Searches arrive as natural language\n  (\"rate limit\", \"retry delay\"), and camelCase identifiers don't match phrase greps —\n  `RateLimiter` is invisible to a search for \"rate limit\". The doc comment above each\n  export should contain, in ordinary spaced-out words, the phrase someone would search\n  for: a `SessionExpiryChecker` should say \u002F\\*_ Checks whether the user session has\n  expired. _\u002F so that a grep for \"session expired\" or \"session has expired\" lands here.\n- **A module should make sense with its imports unread.** Each imported name plus its\n  doc line should say enough that the reader never has to open the source module. If\n  they do, the import's name is failing, not the reader.\n- **Keep strings whole.** Never build event names, flags, or error codes with template\n  interpolation (`` `github.${entity}.${action}` `` makes `github.pr.merged` unsearchable).\n  Write the full literal even when a loop feels DRYer.\n- **Error messages start with a unique literal prefix**, so a message seen in a log greps\n  straight back to the throw site. ``throw new Error(`Webhook signature mismatch for ${id}`)``,\n  never ``throw new Error(`${prefix}: mismatch`)``.\n- **One searchable concept per file, and keep orchestrators thin.** The code that answers\n  \"where is X done?\" should live in a module named after X — the thing a reader would\n  ask about, not the mechanism inside — not inline in a coordinator,\n  pipeline, or service class. An orchestrator should read as a sequence of calls into\n  well-named modules; if a reader lands in it from a search, every line should point them\n  one hop from the real implementation. Burying the implementation of several concepts in\n  one large file makes every search for any of them land on the same wall of code.\n  Split until each question-sized concept has one named home, then stop: a helper\n  meaningful only inside one concept belongs inline, and a file per tiny function\n  fragments one answer across several reads. The test runs both ways: a module that\n  answers many unrelated questions is holding more than one concept.\n- **Colocate tests** (`foo.test.ts` next to `foo.ts`) so one search finds behavior and its\n  specification together.\n- **Mark dead ends.** `@deprecated` on the old path, with a pointer to the new one.\n\n## Quick checklist before committing\n\n1. Would one search for each new exported name be enough to find its implementation?\n2. Would swapping two arguments of the new function fail the build?\n3. Is the one thing a caller must know but the signature can't say (units, timezone,\n   ownership, ordering) written right at the definition?\n4. Do all log\u002Ferror strings exist verbatim in the source?\n5. Did anything change behavior without changing its name?\n6. When code moved, is it gone from where it came from?\n","# Write discoverable code\n\nCoding agents discover code by searching for strings and reading small windows around the\nhits. They have no hover text, no jump-to-definition, and no memory between sessions. These\nrules make code resolvable in one search instead of five.\n\n## 1. Names are search queries\n\n- **Exported symbols get 2–4 word names, at least one of them a domain word.**\n  `diffUserObjects`, not `diff`. `queueEventForDispatch`, not `queue`.\n  Measured on a ~700k-line monorepo: 1-word exported names are globally unique 61% of\n  the time; 3-word names 96%; 4+ words 98%. Three words is the knee of the curve.\n  Use the shortest name that greps uniquely; put the rest in the doc comment.\n- **Give generic verbs their object.** `sanitizeEmailHtml`, not `sanitize`;\n  `validateSmtpConfig`, not `validateConfig`. Qualify only as far as uniqueness\n  requires, then stop.\n- **One definition site per symbol.** Never copy a function between files; move it and\n  delete the original in the same change. Shared helpers get one concept-named home\n  and are imported everywhere else.\n- **Do not rely on the module path to disambiguate a generic name.** The import that\n  disambiguates `users\u002Fdiff.ts` from `orders\u002Fdiff.ts` sits at the top of the file; the\n  search hit is at line 300. Put the context in the symbol (`formatDurationMs`), not the\n  folder. Exception: rigid, absolute conventions where the path carries the meaning\n  (e.g. every contract file exporting `Input`\u002F`Output`).\n- **One concept, one spelling.** Pick `organizationId` or `orgId` and use it everywhere;\n  every synonym splits every future search in half. Reuse existing vocabulary in the\n  codebase you are editing rather than introducing near-synonyms.\n- **When behavior or audience changes, rename in the same commit.** A stale name is\n  misinformation with a 100% open rate — that includes visibility markers: a `_private`\n  helper that other modules now import needs a public name.\n- **Filenames are names too — never use bare-role filenames.** `config.ts`, `types.ts`,\n  `utils.ts`, `helpers.ts`, `handlers.ts` say nothing in a search result and collide with\n  every other module's config\u002Ftypes\u002Futils in the repo. Prefix the domain:\n  `billing-plan-config.ts`, not `config.ts`. (`index.ts` is acceptable only as a\n  thin re-export entry point.)\n\n## 2. Types are the documentation agents can't skip\n\n- **Brand your primitive IDs.** `z.string().brand\u003C'UserId'>()` (TS) or newtypes (Rust).\n  A `transferOwnership(userId: string, orgId: string)` signature makes argument\n  transposition invisible; branded types make it a compile error that names the concepts.\n- **Use capability-token parameter types** for privileged operations (e.g. requiring an\n  `OrgScopedDb` instead of a raw connection). A comment is a request; a required type is\n  physics.\n- **Model state with discriminated unions**, not clusters of nullable fields with implicit\n  rules.\n- **Name types like they'll be quoted back** — they will be, in compiler errors the agent\n  uses to self-correct. `OrgScopedDb` explains itself; `Ctx2` does not. Avoid `any`: every\n  `any` is a spot where the compiler goes silent and the agent is back to guessing.\n\n## 3. Say it where the search lands\n\n- **One-line doc comment on every export**, stating the sharpest constraint the code\n  itself can't show (units, timezone, \"source time, not insert time\", ownership).\n  The definition is where a name search lands; that line is your whole message.\n- **Write the plain-words phrase in the doc comment.** Searches arrive as natural language\n  (\"rate limit\", \"retry delay\"), and camelCase identifiers don't match phrase greps —\n  `RateLimiter` is invisible to a search for \"rate limit\". The doc comment above each\n  export should contain, in ordinary spaced-out words, the phrase someone would search\n  for: a `SessionExpiryChecker` should say \u002F\\*_ Checks whether the user session has\n  expired. _\u002F so that a grep for \"session expired\" or \"session has expired\" lands here.\n- **A module should make sense with its imports unread.** Each imported name plus its\n  doc line should say enough that the reader never has to open the source module. If\n  they do, the import's name is failing, not the reader.\n- **Keep strings whole.** Never build event names, flags, or error codes with template\n  interpolation (`` `github.${entity}.${action}` `` makes `github.pr.merged` unsearchable).\n  Write the full literal even when a loop feels DRYer.\n- **Error messages start with a unique literal prefix**, so a message seen in a log greps\n  straight back to the throw site. ``throw new Error(`Webhook signature mismatch for ${id}`)``,\n  never ``throw new Error(`${prefix}: mismatch`)``.\n- **One searchable concept per file, and keep orchestrators thin.** The code that answers\n  \"where is X done?\" should live in a module named after X — the thing a reader would\n  ask about, not the mechanism inside — not inline in a coordinator,\n  pipeline, or service class. An orchestrator should read as a sequence of calls into\n  well-named modules; if a reader lands in it from a search, every line should point them\n  one hop from the real implementation. Burying the implementation of several concepts in\n  one large file makes every search for any of them land on the same wall of code.\n  Split until each question-sized concept has one named home, then stop: a helper\n  meaningful only inside one concept belongs inline, and a file per tiny function\n  fragments one answer across several reads. The test runs both ways: a module that\n  answers many unrelated questions is holding more than one concept.\n- **Colocate tests** (`foo.test.ts` next to `foo.ts`) so one search finds behavior and its\n  specification together.\n- **Mark dead ends.** `@deprecated` on the old path, with a pointer to the new one.\n\n## Quick checklist before committing\n\n1. Would one search for each new exported name be enough to find its implementation?\n2. Would swapping two arguments of the new function fail the build?\n3. Is the one thing a caller must know but the signature can't say (units, timezone,\n   ownership, ordering) written right at the definition?\n4. Do all log\u002Ferror strings exist verbatim in the source?\n5. Did anything change behavior without changing its name?\n6. When code moved, is it gone from where it came from?\n",{"name":5,"license":14,"description":23},"Rules for writing code that coding agents (and humans) can find and understand through\nplain-text search. Apply whenever writing or renaming code: functions, types, constants,\nfiles, error messages, doc comments.\n\nGrounded in measurement: agents navigate by plain-text search, not by AST or\nlanguage server, so every identifier is a search query and every search miss\ncosts wasted reads.\n","main","23a759da55169dbb6708db4107a640d51bc38494","home\u002F.agents\u002Fskills\u002Fwrite-discoverable-code","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles","https:\u002F\u002Fgithub.com\u002Fgeoquant","2026-11-07 14:23:21",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add geoquant\u002F.dotfiles --skill write-discoverable-code",{"tool":36,"command":37},"bunx","bunx skills add geoquant\u002F.dotfiles --skill write-discoverable-code",{"tool":39,"command":40},"pnpm","pnpm dlx skills add geoquant\u002F.dotfiles --skill write-discoverable-code","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Fwrite-discoverable-code\u002FSKILL.md",true,[],[45,53,61,69,77],{"skillNo":46,"name":47,"nameZh":6,"description":48,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":49,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M7C6YDPZZCEYZ8GDC9WZP9ZB","typesafe-ai","Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives. Its System One models, including Jev, turn natural language and application state into typed judgments and probabilities that code can combine. Use when a feature needs programmable common sense, when brainstorming what AI could make possible in an app, or when an LLM prompt-and-parse step could become a structured decision. Applications include routing, ranking, extraction, verification, and interactive experiences; these are starting points, not the limits. Read live docs and cookbooks to find useful patterns and discover new combinations.","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Ftypesafe-ai\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Ftypesafe-ai\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":57,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M7C6VMRAQ87C0HTHRCGTWBAN","noodle","Operate the Noodle CLI — explain commands, find flags, create\u002Fedit .noodle.toml config. Also covers writing skills for Noodle: the orders pipeline, task-type schedule fields, stage composition, and the orders-next.json schema. Use when running noodle commands, editing .noodle.toml, writing or updating a skill's schedule field, authoring new task-type skills, or asking \"how to run noodle\", \"noodle help\", \"configure noodle\".","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Fnoodle\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Fnoodle\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":65,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":18},"01M7C6TF5YQDVYR23MXQB3R67R","how","Explain how something works in this codebase by exploring code and producing a clear architectural explanation. Optionally critique the architecture for issues.","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Fhow\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Fhow\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":73,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M7C6SDM60ZK1405Q4Q49HR4R","decision-models","Classifier models (Jev, Clef) that answer typed questions about state with calibrated probabilities. Use when calling `models.classify` in pi codemode; when building or debugging code that calls Jev or Clef; or when replacing an LLM prompt-and-parse step, keyword match, or heuristic with typed questions.","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Fdecision-models\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Fdecision-models\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":81,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":18},"01M7C6S1XSC7E5VCCGZ5KJAYXC","cua-driver","Drive a native GUI app (macOS, Windows, Linux) via the cua-driver CLI (default) or MCP server; snapshot its accessibility tree, act through snapshot-bound element tokens, native menu paths, exact window geometry, or pixel coordinates, and verify from fresh state. Use when the user asks you to operate, drive, automate, or perform a GUI task in a real application on the host, or to continue, resume, or recall recent Cua activity.","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Fcua-driver\u002FLICENSE.md","https:\u002F\u002Fgithub.com\u002Fgeoquant\u002F.dotfiles\u002Fblob\u002Fmain\u002Fhome\u002F.agents\u002Fskills\u002Fcua-driver\u002FSKILL.md",[],[]]