[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79PFXGT1EQQQBBGYCS6RSF9":3,"skill-same:01M79PFXGT1EQQQBBGYCS6RSF9":54},{"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":5,"forksCount":14,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":28,"updatedAt":29,"install":30,"resources":43},"01M79PFXGT1EQQQBBGYCS6RSF9","effect-service-design",null,"Design Effect services. Use when designing a new Effect service module or auditing an existing codebase for service, Layer, and composition improvements.","sixfourtwelve\u002Fskills","sixfourtwelve","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F32551776?v=4","01M79PFEBJR5V9Y52W344BMSXG","emorgan","01M79PFECQ0F8B104SWVAX919J",0,"MIT","https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills\u002Fblob\u002Fmain\u002Feffect-service-design\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: effect-service-design\ndescription: Design Effect services. Use when designing a new Effect service module or auditing an existing codebase for service, Layer, and composition improvements.\n---\n\n# Effect Service Design\n\nTreat a service as an **authority seam**: a cohesive capability whose requirements should propagate through Effect context. An **Effect service module** owns the service contract, construction, production Layer, and any honest reusable test implementation that belong to the same capability.\n\n## 1. Establish the local rules\n\nRead the nearest `AGENTS.md`, architecture docs, coding standards, project Effect guidance, pinned Effect version\u002Fsource, and relevant vendored examples. Prefer current project-compatible patterns over remembered APIs.\n\n**Complete when:** the governing files and pinned source examples have been read and recorded for use in later decisions.\n\n## 2. Select the branch\n\n- **Design branch:** for a new service or a focused redesign, bound the capability, trace one caller-visible operation to every effect, then continue below.\n- **Audit branch:** for a codebase, package, feature slice, or diff, read and follow [`references\u002FAUDIT.md`](references\u002FAUDIT.md), applying the rules below to every candidate it finds.\n\n**Complete when:** one branch is selected, its scope is bounded, and the caller-visible operations in scope are named.\n\n## 3. Apply the service test\n\nA real service owns at least one meaningful capability:\n\n- authority over persistence, credentials, external I\u002FO, runtime resources, configuration, time, randomness, or lifecycle;\n- cohesive effect sequencing or policy reused across entrypoints;\n- state or behavior with real production and test\u002Fruntime variation;\n- enough implementation complexity that deleting the module would spread complexity into callers.\n\nPrefer an existing Effect service such as `Clock`, `Crypto`, `Random`, `Config`, `HttpClient`, `FileSystem`, or `Path` before defining an application service.\n\nKeep these as values or pure modules:\n\n- parsed domain inputs and per-call request data;\n- deterministic calculations, projections, parsers, and constructors;\n- options that select policy for one call;\n- framework values confined to their adapter;\n- wrappers that only rename or forward another service.\n\nA test-only desire to inject a value is not enough. The seam must represent real ownership or variability in production.\n\n**Complete when:** the deletion test and the existing-service\u002Fadapter audit both support either “service” or “value,” and the rejected alternative is stated plainly.\n\n## 4. Place the authority seam\n\n- Domain modules stay pure.\n- Application services own operation policy and application-owned ports.\n- A port's tag and interface live beside the application operation that needs them.\n- A concrete adapter owns its technology-specific `make` and `layer`; it need not share a file with the application-owned port.\n- Composition roots select and provide concrete Layers. They do not become reusable policy modules.\n- Runtime bindings are yielded in the composition root or owning adapter, then hidden behind application\u002Fdomain types.\n\nYield stable dependencies while building the Layer and close over them in service methods. Yield request-, fiber-, or operation-scoped context inside the method that uses it. Let requirements propagate until the module that truthfully chooses an implementation provides them.\n\nPassing an external library's constructor options remains correct after the owning adapter has yielded the relevant runtime capability. React props, request values, domain inputs, and framework constructors are not Effect dependency injection.\n\n**Complete when:** dependencies point inward, raw technology types stop at adapters, and no inner caller chooses a concrete implementation it does not own.\n\n## 5. Shape the Effect service module\n\nFollow the project's established equivalent of this shape:\n\n```ts\nexport interface Interface {\n  readonly operation: (input: Input) => Effect.Effect\u003COutput, OperationError>\n}\n\nexport class Service extends Context.Service\u003CService, Interface>()(\n  \"@app\u002FCapability\",\n) {}\n\nexport const make: Effect.Effect\u003C\n  Service[\"Service\"],\n  never,\n  Dependency.Service\n> = Effect.gen(function* () {\n  const dependency = yield* Dependency.Service\n\n  const operation = Effect.fn(\"Capability.operation\")(function* (input: Input) {\n    return yield* dependency.operation(input)\n  })\n\n  return Service.of({ operation })\n})\n\nexport const layerWithoutDependencies = Layer.effect(Service, make)\n\nexport const layer = layerWithoutDependencies.pipe(\n  Layer.provide([Dependency.layer]),\n)\n\nexport const layerTest = Layer.succeed(\n  Service,\n  Service.of({\n    operation: (_input) => Effect.succeed(testOutput),\n  }),\n)\n```\n\n`layerWithoutDependencies` preserves the service's requirements for composition. `layer` is the ready production assembly and provides the concrete dependency Layers. `layerTest` illustrates a complete static substitute; export it only when that behavior is reusable and honest. Use `layerMemory` instead when an in-memory implementation faithfully preserves the observable contract.\n\nUse `Layer.succeed` for an already-built value, `Layer.sync` for lazy synchronous construction, and `Layer.effect` for effectful acquisition. Preserve an established compatible naming convention when renaming would add churn without clarity.\n\nKeep interfaces narrow and domain-shaped. Use named `Effect.fn` methods, typed expected errors, and yielded dependencies. Add options, methods, services, and combinators only when each hides enough complexity to earn its place.\n\n**Complete when:** the tag, interface, `make`, dependency-preserving Layer, production `layer`, errors, methods, and test strategy have one clear owner, and every exported symbol is required by a caller.\n\n## 6. Choose test Layers honestly\n\n- Use `Layer.succeed` for a complete static implementation.\n- Add `layerTest` plus a test-control service when reusable state, failure injection, or observation is part of a real seam.\n- Name a Layer `layerMemory` only when it faithfully implements the service's observable contract in memory.\n- Prefer a real local substitute when persistence, transactions, serialization, or protocol behavior matters.\n- Keep a tiny one-off fake in its test when promoting it would create production surface solely for that test.\n\nTests cross the same service interface as production callers. When a reusable control service exists, back its production tag and test-control tag with the same object. Partial objects with “unused” methods that die are focused test fixtures, not reusable in-memory adapters.\n\n**Complete when:** each test implementation is complete for its advertised name, tests observe outcomes through the public interface, and no new seam exists only to support mocking.\n\n## 7. Finish the selected branch\n\n- **Design branch:** record the service-or-value decision and its evidence. When implementation is requested, create or refactor the module, update composition roots and tests, and run the repository's required checks.\n- **Audit branch:** produce prioritized findings with file\u002Fline or symbol evidence, target module shapes, composition and test impact, and explicit “keep” decisions.\n\n**Complete when:** the designed capability has an explicit disposition and validated implementation when requested, or every audit inventory row has a disposition; validation passes or every failure is reported.\n","# Effect Service Design\n\nTreat a service as an **authority seam**: a cohesive capability whose requirements should propagate through Effect context. An **Effect service module** owns the service contract, construction, production Layer, and any honest reusable test implementation that belong to the same capability.\n\n## 1. Establish the local rules\n\nRead the nearest `AGENTS.md`, architecture docs, coding standards, project Effect guidance, pinned Effect version\u002Fsource, and relevant vendored examples. Prefer current project-compatible patterns over remembered APIs.\n\n**Complete when:** the governing files and pinned source examples have been read and recorded for use in later decisions.\n\n## 2. Select the branch\n\n- **Design branch:** for a new service or a focused redesign, bound the capability, trace one caller-visible operation to every effect, then continue below.\n- **Audit branch:** for a codebase, package, feature slice, or diff, read and follow [`references\u002FAUDIT.md`](references\u002FAUDIT.md), applying the rules below to every candidate it finds.\n\n**Complete when:** one branch is selected, its scope is bounded, and the caller-visible operations in scope are named.\n\n## 3. Apply the service test\n\nA real service owns at least one meaningful capability:\n\n- authority over persistence, credentials, external I\u002FO, runtime resources, configuration, time, randomness, or lifecycle;\n- cohesive effect sequencing or policy reused across entrypoints;\n- state or behavior with real production and test\u002Fruntime variation;\n- enough implementation complexity that deleting the module would spread complexity into callers.\n\nPrefer an existing Effect service such as `Clock`, `Crypto`, `Random`, `Config`, `HttpClient`, `FileSystem`, or `Path` before defining an application service.\n\nKeep these as values or pure modules:\n\n- parsed domain inputs and per-call request data;\n- deterministic calculations, projections, parsers, and constructors;\n- options that select policy for one call;\n- framework values confined to their adapter;\n- wrappers that only rename or forward another service.\n\nA test-only desire to inject a value is not enough. The seam must represent real ownership or variability in production.\n\n**Complete when:** the deletion test and the existing-service\u002Fadapter audit both support either “service” or “value,” and the rejected alternative is stated plainly.\n\n## 4. Place the authority seam\n\n- Domain modules stay pure.\n- Application services own operation policy and application-owned ports.\n- A port's tag and interface live beside the application operation that needs them.\n- A concrete adapter owns its technology-specific `make` and `layer`; it need not share a file with the application-owned port.\n- Composition roots select and provide concrete Layers. They do not become reusable policy modules.\n- Runtime bindings are yielded in the composition root or owning adapter, then hidden behind application\u002Fdomain types.\n\nYield stable dependencies while building the Layer and close over them in service methods. Yield request-, fiber-, or operation-scoped context inside the method that uses it. Let requirements propagate until the module that truthfully chooses an implementation provides them.\n\nPassing an external library's constructor options remains correct after the owning adapter has yielded the relevant runtime capability. React props, request values, domain inputs, and framework constructors are not Effect dependency injection.\n\n**Complete when:** dependencies point inward, raw technology types stop at adapters, and no inner caller chooses a concrete implementation it does not own.\n\n## 5. Shape the Effect service module\n\nFollow the project's established equivalent of this shape:\n\n```ts\nexport interface Interface {\n  readonly operation: (input: Input) => Effect.Effect\u003COutput, OperationError>\n}\n\nexport class Service extends Context.Service\u003CService, Interface>()(\n  \"@app\u002FCapability\",\n) {}\n\nexport const make: Effect.Effect\u003C\n  Service[\"Service\"],\n  never,\n  Dependency.Service\n> = Effect.gen(function* () {\n  const dependency = yield* Dependency.Service\n\n  const operation = Effect.fn(\"Capability.operation\")(function* (input: Input) {\n    return yield* dependency.operation(input)\n  })\n\n  return Service.of({ operation })\n})\n\nexport const layerWithoutDependencies = Layer.effect(Service, make)\n\nexport const layer = layerWithoutDependencies.pipe(\n  Layer.provide([Dependency.layer]),\n)\n\nexport const layerTest = Layer.succeed(\n  Service,\n  Service.of({\n    operation: (_input) => Effect.succeed(testOutput),\n  }),\n)\n```\n\n`layerWithoutDependencies` preserves the service's requirements for composition. `layer` is the ready production assembly and provides the concrete dependency Layers. `layerTest` illustrates a complete static substitute; export it only when that behavior is reusable and honest. Use `layerMemory` instead when an in-memory implementation faithfully preserves the observable contract.\n\nUse `Layer.succeed` for an already-built value, `Layer.sync` for lazy synchronous construction, and `Layer.effect` for effectful acquisition. Preserve an established compatible naming convention when renaming would add churn without clarity.\n\nKeep interfaces narrow and domain-shaped. Use named `Effect.fn` methods, typed expected errors, and yielded dependencies. Add options, methods, services, and combinators only when each hides enough complexity to earn its place.\n\n**Complete when:** the tag, interface, `make`, dependency-preserving Layer, production `layer`, errors, methods, and test strategy have one clear owner, and every exported symbol is required by a caller.\n\n## 6. Choose test Layers honestly\n\n- Use `Layer.succeed` for a complete static implementation.\n- Add `layerTest` plus a test-control service when reusable state, failure injection, or observation is part of a real seam.\n- Name a Layer `layerMemory` only when it faithfully implements the service's observable contract in memory.\n- Prefer a real local substitute when persistence, transactions, serialization, or protocol behavior matters.\n- Keep a tiny one-off fake in its test when promoting it would create production surface solely for that test.\n\nTests cross the same service interface as production callers. When a reusable control service exists, back its production tag and test-control tag with the same object. Partial objects with “unused” methods that die are focused test fixtures, not reusable in-memory adapters.\n\n**Complete when:** each test implementation is complete for its advertised name, tests observe outcomes through the public interface, and no new seam exists only to support mocking.\n\n## 7. Finish the selected branch\n\n- **Design branch:** record the service-or-value decision and its evidence. When implementation is requested, create or refactor the module, update composition roots and tests, and run the repository's required checks.\n- **Audit branch:** produce prioritized findings with file\u002Fline or symbol evidence, target module shapes, composition and test impact, and explicit “keep” decisions.\n\n**Complete when:** the designed capability has an explicit disposition and validated implementation when requested, or every audit inventory row has a disposition; validation passes or every failure is reported.\n",{"name":5,"description":7},"main","e735d72067b5a78cbfce066cbf779615b39bbb90","https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills","https:\u002F\u002Fgithub.com\u002Fsixfourtwelve","plan. apply. panic.","2026-08-05 20:04:16",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add sixfourtwelve\u002Fskills --skill effect-service-design",{"tool":36,"command":37},"bunx","bunx skills add sixfourtwelve\u002Fskills --skill effect-service-design",{"tool":39,"command":40},"pnpm","pnpm dlx skills add sixfourtwelve\u002Fskills --skill effect-service-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills\u002Fblob\u002Fmain\u002Feffect-service-design\u002FSKILL.md",true,[44,50],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"agents\u002Fopenai.yaml","REFERENCE","参考文档",114,"https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills\u002Fblob\u002Fmain\u002Feffect-service-design\u002Fagents\u002Fopenai.yaml",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"references\u002FAUDIT.md",5038,"https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills\u002Fblob\u002Fmain\u002Feffect-service-design\u002Freferences\u002FAUDIT.md",[55,62,69,76,83,90],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M79PH87N4FJ46S7WXTSPMR63","yeetslop","Remove AI-generated code slop introduced in the current branch. User-invoked only.","https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills\u002Fblob\u002Fmain\u002Fyeetslop\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M79PH55ZVYN5D69XPC67BV7X","review-pass","Review a diff, branch, or PR for correctness, security, and quality issues. Use when asked to review code changes, review a PR, or do a code review — especially useful in agents without a built-in review command.","https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills\u002Fblob\u002Fmain\u002Freview-pass\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M79PH0Y202N6F6WWDHHYXRH6","release-notes","Draft release notes or changelog entries from a commit or tag range. Use when asked to write release notes, draft a changelog, or summarize what changed between two versions or tags.","https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills\u002Fblob\u002Fmain\u002Frelease-notes\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M79PGWHBCHQYMX0YFYYCH3G6","pr-writer","Draft a pull request title and description from the current branch's diff and commit history. Use when asked to write a PR description, draft a PR, or prepare a branch for review.","https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills\u002Fblob\u002Fmain\u002Fpr-writer\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M79PGQPRJ7R8JVKAF7HWWS4Y","objfw","Opinionated guide for writing, debugging, reviewing, and testing Objective-C when the target uses ObjFW. Use for ObjFW classes and APIs, ObjFW-style types, ARC, exceptions, strings, collections, streams, sockets, run loops, portability, objfw-compile, or ObjFWTest in an ObjFW project.","https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills\u002Fblob\u002Fmain\u002Fobjfw\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M79PGMNC34FC6G5CJEH7EPMT","noteday","Log today's work — a summary of the day plus any tickets worked on — as an entry in the personal Notion \"Daily Log\" database. Use when the user runs \u002Fnoteday or asks to note down their day.","https:\u002F\u002Fgithub.com\u002Fsixfourtwelve\u002Fskills\u002Fblob\u002Fmain\u002Fnoteday\u002FSKILL.md",[],[]]