[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ASY853FG5NZC3YBQVZPX5F":3,"skill-same:01M7ASY853FG5NZC3YBQVZPX5F":59},{"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":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7ASY853FG5NZC3YBQVZPX5F","thin-wrappers",null,"Encapsulates infrastructure SDKs behind minimal domain-aligned interfaces. Use when accessing any external infrastructure to keep SDK usage contained, testing simple, and changes easy.","saski\u002Farnesto","saski","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F140356?v=4","01M7ASBDSNXTRYDYB4K1PEA1RV","01M7ASBDTAKBDAAV99S1GE7HK6",6,"Unlicense","https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fthin-wrappers\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: thin-wrappers\ndescription: Encapsulates infrastructure SDKs behind minimal domain-aligned interfaces. Use when accessing any external infrastructure to keep SDK usage contained, testing simple, and changes easy.\n---\n\nSTARTER_CHARACTER = 🏗️\n\n# Thin Infrastructure Wrappers\n\n## Core Principle\n\nMinimize the API surface area: expose only what you use today, in your domain's language. The wrapper should be significantly smaller than the SDK it wraps.\n\n## When to Apply\n\nApply thin wrappers when:\n- Direct SDK usage spreads across the codebase\n- Infrastructure concerns leak into business logic\n- Testing requires mocking third-party libraries directly\n- Switching providers or versions creates ripple effects\n- SDK types and concepts appear in domain code\n\nSkip when:\n- The SDK is already minimal and domain-aligned\n- Usage is isolated to a single boundary class\n- The abstraction cost exceeds the coupling cost\n\n## Design Process\n\n### 1. Identify Usage Patterns\n\nAnalyze existing SDK usage across the codebase:\n- Find all import statements for the SDK\n- Catalog which SDK methods are actually used\n- Group usage by purpose (read, write, delete, etc.)\n- Apply the 80% rule: focus on covering the most common operations first\n\n### 2. Design Minimal Interface\n\nCreate an interface exposing only what's needed:\n- Use domain terminology, not SDK terminology\n- Expose operations, not SDK objects or types\n- Keep method signatures simple and focused\n- Prevent SDK types from escaping the wrapper\n\nAnti-pattern: Exposing entire SDK \"just in case\"\n\nExample transformation:\n- SDK: `cache.set(key, value, ex=ttl, nx=True)`\n- Wrapper: `cache.set_if_not_exists(key, value, ttl)`\n\n### 3. Choose Implementation Pattern\n\n**Two-layer approach** (most common):\n- Thin wrapper: Direct SDK encapsulation, minimal logic\n- Domain class: Business logic using the wrapper\n\nUse when business logic needs to be separated from infrastructure.\n\n**Single-class approach**:\n- Combine wrapper and domain logic in one class\n\nUse when wrapper logic is minimal and business logic is simple.\n\n### 4. Implement with Domain Language\n\nAlign method names and parameters with domain concepts:\n- `publish_order_created(order_id, customer_id)` not `publish(topic, message)`\n- `fetch_user_profile(user_id)` not `get(bucket, key)`\n- `store_uploaded_file(file_id, content)` not `put_object(params)`\n\n## Gradual Refactoring\n\nMigrate existing code incrementally:\n\n1. **Create wrapper for 80% case**: Start with most common usage patterns\n2. **Replace one usage site at a time**: Incremental, safe changes\n3. **Measure progress**: Track remaining direct SDK calls\n4. **Refine interface**: Adjust based on actual migration experience\n5. **Complete migration**: Handle remaining edge cases\n\nEach step should be independently committable and testable.\n\n## Integration with Architecture\n\nThin wrappers naturally map to the adapter layer in hexagonal\u002Fclean architecture, implementing domain-defined ports.\n\n## Testing\n\nThin wrappers enable simple test doubles — no mocking libraries needed. See examples for test double implementations.\n\n## Anti-Patterns\n\n**Exposing SDK Types**: Don't let SDK classes or enums leak through the wrapper boundary. Transform them into domain types.\n\n**Premature Abstraction**: Don't create wrappers for single-use SDKs. Wait until usage patterns emerge.\n\n**Over-Engineering**: Don't add configuration, features, or flexibility beyond current needs. Simple is better.\n\n**Generic Wrappers**: Don't create `DatabaseWrapper` or `QueueWrapper` with every possible method. Expose only what the application uses.\n\n**Pass-Through Methods**: Don't just rename SDK methods without adding domain meaning. Each wrapper method should represent a domain operation.\n\n## Examples\n\nSee reference implementations for common infrastructure types:\n\n- **Cache\u002FRedis**: [references\u002Fcache-example.md](references\u002Fcache-example.md)\n- **Queue\u002FMessaging**: [references\u002Fqueue-example.md](references\u002Fqueue-example.md)\n- **Storage\u002FS3**: [references\u002Fstorage-example.md](references\u002Fstorage-example.md)\n\nThese illustrate the principles. Consider what fits your context.\n","STARTER_CHARACTER = 🏗️\n\n# Thin Infrastructure Wrappers\n\n## Core Principle\n\nMinimize the API surface area: expose only what you use today, in your domain's language. The wrapper should be significantly smaller than the SDK it wraps.\n\n## When to Apply\n\nApply thin wrappers when:\n- Direct SDK usage spreads across the codebase\n- Infrastructure concerns leak into business logic\n- Testing requires mocking third-party libraries directly\n- Switching providers or versions creates ripple effects\n- SDK types and concepts appear in domain code\n\nSkip when:\n- The SDK is already minimal and domain-aligned\n- Usage is isolated to a single boundary class\n- The abstraction cost exceeds the coupling cost\n\n## Design Process\n\n### 1. Identify Usage Patterns\n\nAnalyze existing SDK usage across the codebase:\n- Find all import statements for the SDK\n- Catalog which SDK methods are actually used\n- Group usage by purpose (read, write, delete, etc.)\n- Apply the 80% rule: focus on covering the most common operations first\n\n### 2. Design Minimal Interface\n\nCreate an interface exposing only what's needed:\n- Use domain terminology, not SDK terminology\n- Expose operations, not SDK objects or types\n- Keep method signatures simple and focused\n- Prevent SDK types from escaping the wrapper\n\nAnti-pattern: Exposing entire SDK \"just in case\"\n\nExample transformation:\n- SDK: `cache.set(key, value, ex=ttl, nx=True)`\n- Wrapper: `cache.set_if_not_exists(key, value, ttl)`\n\n### 3. Choose Implementation Pattern\n\n**Two-layer approach** (most common):\n- Thin wrapper: Direct SDK encapsulation, minimal logic\n- Domain class: Business logic using the wrapper\n\nUse when business logic needs to be separated from infrastructure.\n\n**Single-class approach**:\n- Combine wrapper and domain logic in one class\n\nUse when wrapper logic is minimal and business logic is simple.\n\n### 4. Implement with Domain Language\n\nAlign method names and parameters with domain concepts:\n- `publish_order_created(order_id, customer_id)` not `publish(topic, message)`\n- `fetch_user_profile(user_id)` not `get(bucket, key)`\n- `store_uploaded_file(file_id, content)` not `put_object(params)`\n\n## Gradual Refactoring\n\nMigrate existing code incrementally:\n\n1. **Create wrapper for 80% case**: Start with most common usage patterns\n2. **Replace one usage site at a time**: Incremental, safe changes\n3. **Measure progress**: Track remaining direct SDK calls\n4. **Refine interface**: Adjust based on actual migration experience\n5. **Complete migration**: Handle remaining edge cases\n\nEach step should be independently committable and testable.\n\n## Integration with Architecture\n\nThin wrappers naturally map to the adapter layer in hexagonal\u002Fclean architecture, implementing domain-defined ports.\n\n## Testing\n\nThin wrappers enable simple test doubles — no mocking libraries needed. See examples for test double implementations.\n\n## Anti-Patterns\n\n**Exposing SDK Types**: Don't let SDK classes or enums leak through the wrapper boundary. Transform them into domain types.\n\n**Premature Abstraction**: Don't create wrappers for single-use SDKs. Wait until usage patterns emerge.\n\n**Over-Engineering**: Don't add configuration, features, or flexibility beyond current needs. Simple is better.\n\n**Generic Wrappers**: Don't create `DatabaseWrapper` or `QueueWrapper` with every possible method. Expose only what the application uses.\n\n**Pass-Through Methods**: Don't just rename SDK methods without adding domain meaning. Each wrapper method should represent a domain operation.\n\n## Examples\n\nSee reference implementations for common infrastructure types:\n\n- **Cache\u002FRedis**: [references\u002Fcache-example.md](references\u002Fcache-example.md)\n- **Queue\u002FMessaging**: [references\u002Fqueue-example.md](references\u002Fqueue-example.md)\n- **Storage\u002FS3**: [references\u002Fstorage-example.md](references\u002Fstorage-example.md)\n\nThese illustrate the principles. Consider what fits your context.\n",{"name":5,"description":7},"main","3c24fc2c035029b08c7326774bee3fef8fb95566",".agents\u002Fskills\u002Fthin-wrappers",0,"https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto","https:\u002F\u002Fgithub.com\u002Fsaski","http:\u002F\u002Fsaski.com","2026-11-12 20:09:16",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add saski\u002Farnesto --skill thin-wrappers",{"tool":37,"command":38},"bunx","bunx skills add saski\u002Farnesto --skill thin-wrappers",{"tool":40,"command":41},"pnpm","pnpm dlx skills add saski\u002Farnesto --skill thin-wrappers","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fthin-wrappers\u002FSKILL.md",true,[45,51,55],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"references\u002Fcache-example.md","REFERENCE","参考文档",4653,"https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fthin-wrappers\u002Freferences\u002Fcache-example.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fqueue-example.md",8181,"https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fthin-wrappers\u002Freferences\u002Fqueue-example.md",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fstorage-example.md",9656,"https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fthin-wrappers\u002Freferences\u002Fstorage-example.md",[60,67,74,81,88,95],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M7AT7F5FSHNAMFMF01N0QA1X","visualize","Use \u002Fvisualize for creating compact charts, diagrams, or other visuals inline as part of the conversation itself. It chooses among Markdown tables, Mermaid, inline HTML, and other supported in-transcript forms. Use Canvas for durable artifacts outside the transcript that users may revisit, refine, or share.","https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.cursor\u002Fskills-cursor\u002Fvisualize\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7AT79MHSAR3JDDMP7DGERM9","update-cursor-settings","Modify Cursor\u002FVSCode user settings in settings.json. Use when you want to change editor settings, preferences, configuration, themes, font size, tab size, format on save, auto save, keybindings, or any settings.json values.","https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.cursor\u002Fskills-cursor\u002Fupdate-cursor-settings\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M7AT73WF3Y22E0FKYAMCCJES","update-cli-config","View and modify Cursor CLI configuration settings in ~\u002F.cursor\u002Fcli-config.json. Use when the user wants to change CLI settings, configure permissions, switch approval mode, enable vim mode, toggle display options, configure sandbox, or manage any CLI preferences.","https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.cursor\u002Fskills-cursor\u002Fupdate-cli-config\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M7AT6F3FBP85AJJ5BJNR8B5W","statusline","Configure a custom status line in the CLI. Use when the user mentions status line, statusline, statusLine, CLI status bar, prompt footer customization, or wants to add session context above the prompt.","https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.cursor\u002Fskills-cursor\u002Fstatusline\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M7AT6D24QFS5XRAFN8S5XJ7W","split-to-prs","Split current work into small reviewable PRs. Use when the user asks to split a chat, set of changes, branch, or PR.","https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.cursor\u002Fskills-cursor\u002Fsplit-to-prs\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M7AT69FYFN84XZKW452JV5DF","shell","Runs the rest of a \u002Fshell request as a literal shell command. Use only when the user explicitly invokes \u002Fshell and wants the following text executed directly in the terminal.","https:\u002F\u002Fgithub.com\u002Fsaski\u002Farnesto\u002Fblob\u002Fmain\u002F.cursor\u002Fskills-cursor\u002Fshell\u002FSKILL.md",[],[]]