[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M776J1EJ4TYM2R29FM6AYSHB":3,"skill-same:01M776J1EJ4TYM2R29FM6AYSHB":47},{"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":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M776J1EJ4TYM2R29FM6AYSHB","ha-integration-patterns",null,"Home Assistant custom integration patterns and architectural decisions. Use when building HACS integrations, custom components, or API bridges for Home Assistant. Covers service response data, HTTP views, storage APIs, and integration architecture.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fusimic\u002Fha-integration-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ha-integration-patterns\ndescription: Home Assistant custom integration patterns and architectural decisions. Use when building HACS integrations, custom components, or API bridges for Home Assistant. Covers service response data, HTTP views, storage APIs, and integration architecture.\n---\n\n# Home Assistant Integration Patterns\n\n## Service Response Data Pattern\n\n### The Problem\nBy default, HA services are \"fire-and-forget\" and return empty arrays `[]`.\n\n### The Solution (HA 2023.7+)\nRegister service with `supports_response`:\n\n```python\nfrom homeassistant.helpers.service import SupportsResponse\n\nhass.services.async_register(\n    domain, \n    \"get_full_config\", \n    handle_get_full_config,\n    schema=GET_CONFIG_SCHEMA,\n    supports_response=SupportsResponse.ONLY,  # ← KEY PARAMETER\n)\n```\n\nCall with `?return_response` flag:\n```bash\ncurl -X POST \"$HA_URL\u002Fapi\u002Fservices\u002Fyour_domain\u002Fget_full_config?return_response\"\n```\n\n### Response Handler\n```python\nasync def handle_get_full_config(hass: HomeAssistant, call: ServiceCall):\n    \"\"\"Handle the service call and return data.\"\"\"\n    # ... your logic ...\n    return {\"entities\": entity_data, \"automations\": automation_data}\n```\n\n---\n\n## HTTP View vs Service: When to Use Each\n\n| Use Case | Use | Don't Use |\n|----------|-----|-----------|\n| Return complex data | HTTP View | Service (without response support) |\n| Fire-and-forget actions | Service | HTTP View |\n| Trigger automations | Service | HTTP View |\n| Query state\u002Fconfig | HTTP View | Internal storage APIs |\n\n### HTTP View Pattern\nFor data retrieval APIs:\n\n```python\nfrom homeassistant.components.http import HomeAssistantView\n\nclass OpenClawConfigView(HomeAssistantView):\n    \"\"\"HTTP view for retrieving config.\"\"\"\n    url = \"\u002Fapi\u002Fopenclaw\u002Fconfig\"\n    name = \"api:openclaw:config\"\n    requires_auth = True\n\n    async def get(self, request):\n        hass = request.app[\"hass\"]\n        config = await get_config_data(hass)\n        return json_response(config)\n\n# Register in async_setup:\nhass.http.register_view(OpenClawConfigView())\n```\n\n---\n\n## Critical: Avoid Internal APIs\n\n**Never use underscore-prefixed APIs** — they're private and change between versions.\n\n❌ **Wrong:**\n```python\nstorage_collection = hass.data[\"_storage_collection\"]\n```\n\n✅ **Right:**\n```python\n# Use public APIs only\nfrom homeassistant.helpers.storage import Store\nstore = Store(hass, STORAGE_VERSION, STORAGE_KEY)\n```\n\n---\n\n## Storage Patterns\n\n### For Small Data (Settings, Cache)\n```python\nfrom homeassistant.helpers.storage import Store\n\nSTORAGE_KEY = \"your_domain.storage\"\nSTORAGE_VERSION = 1\n\nstore = Store(hass, STORAGE_VERSION, STORAGE_KEY)\n\n# Save\ndata = {\"entities\": modified_entities}\nawait store.async_save(data)\n\n# Load\ndata = await store.async_load()\n```\n\n### For Large Data (History, Logs)\nUse external database or file storage, not HA storage helpers.\n\n---\n\n## Breaking Changes to Watch\n\n| Change | Version | Migration |\n|--------|---------|-----------|\n| Conversation agents | 2025.x+ | Use `async_process` directly |\n| Service response data | 2023.7+ | Add `supports_response` param |\n| Config entry migration | 2022.x+ | Use `async_migrate_entry` |\n\n**Always check:** https:\u002F\u002Fwww.home-assistant.io\u002Fblog\u002F for your target version range.\n\n---\n\n## HACS Integration Structure\n\n```\ncustom_components\u002Fyour_domain\u002F\n├── __init__.py          # async_setup_entry\n├── config_flow.py       # UI configuration\n├── manifest.json        # Dependencies, version\n├── services.yaml        # Service definitions\n└── storage_services.py  # Your storage logic\n```\n\n### Minimal manifest.json\n```json\n{\n  \"domain\": \"your_domain\",\n  \"name\": \"Your Integration\",\n  \"codeowners\": [\"@yourusername\"],\n  \"config_flow\": true,\n  \"dependencies\": [],\n  \"requirements\": [],\n  \"version\": \"1.0.0\"\n}\n```\n\n---\n\n## Testing Checklist\n\n- [ ] Service calls return expected data (with `?return_response`)\n- [ ] HTTP views accessible with auth token\n- [ ] No underscore-prefixed API usage\n- [ ] Storage persists across restarts\n- [ ] Config flow creates config entry\n- [ ] Error handling returns meaningful messages\n\n---\n\n## Documentation Resources\n\n- Integration basics: `developers.home-assistant.io\u002Fdocs\u002Fcreating_integration_index`\n- Service calls: `developers.home-assistant.io\u002Fdocs\u002Fdev_101_services`\n- HTTP views: `developers.home-assistant.io\u002Fdocs\u002Fapi\u002Fwebserver`\n- Breaking changes: `home-assistant.io\u002Fblog\u002F` (filter by version)\n- HACS guidelines: `hacs.xyz\u002Fdocs\u002Fpublish\u002Fstart`\n\n---\n\n## Lesson Learned\n\nFrom HA-OpenClaw Bridge attempt:\n\n> *\"80% of our issues were discoverable with 30-60 minutes of upfront docs reading. We jumped straight to coding based on assumptions rather than reading how HA actually works.\"*\n\nUse `skills\u002Fpre-coding-research\u002F` methodology before starting.\n","# Home Assistant Integration Patterns\n\n## Service Response Data Pattern\n\n### The Problem\nBy default, HA services are \"fire-and-forget\" and return empty arrays `[]`.\n\n### The Solution (HA 2023.7+)\nRegister service with `supports_response`:\n\n```python\nfrom homeassistant.helpers.service import SupportsResponse\n\nhass.services.async_register(\n    domain, \n    \"get_full_config\", \n    handle_get_full_config,\n    schema=GET_CONFIG_SCHEMA,\n    supports_response=SupportsResponse.ONLY,  # ← KEY PARAMETER\n)\n```\n\nCall with `?return_response` flag:\n```bash\ncurl -X POST \"$HA_URL\u002Fapi\u002Fservices\u002Fyour_domain\u002Fget_full_config?return_response\"\n```\n\n### Response Handler\n```python\nasync def handle_get_full_config(hass: HomeAssistant, call: ServiceCall):\n    \"\"\"Handle the service call and return data.\"\"\"\n    # ... your logic ...\n    return {\"entities\": entity_data, \"automations\": automation_data}\n```\n\n---\n\n## HTTP View vs Service: When to Use Each\n\n| Use Case | Use | Don't Use |\n|----------|-----|-----------|\n| Return complex data | HTTP View | Service (without response support) |\n| Fire-and-forget actions | Service | HTTP View |\n| Trigger automations | Service | HTTP View |\n| Query state\u002Fconfig | HTTP View | Internal storage APIs |\n\n### HTTP View Pattern\nFor data retrieval APIs:\n\n```python\nfrom homeassistant.components.http import HomeAssistantView\n\nclass OpenClawConfigView(HomeAssistantView):\n    \"\"\"HTTP view for retrieving config.\"\"\"\n    url = \"\u002Fapi\u002Fopenclaw\u002Fconfig\"\n    name = \"api:openclaw:config\"\n    requires_auth = True\n\n    async def get(self, request):\n        hass = request.app[\"hass\"]\n        config = await get_config_data(hass)\n        return json_response(config)\n\n# Register in async_setup:\nhass.http.register_view(OpenClawConfigView())\n```\n\n---\n\n## Critical: Avoid Internal APIs\n\n**Never use underscore-prefixed APIs** — they're private and change between versions.\n\n❌ **Wrong:**\n```python\nstorage_collection = hass.data[\"_storage_collection\"]\n```\n\n✅ **Right:**\n```python\n# Use public APIs only\nfrom homeassistant.helpers.storage import Store\nstore = Store(hass, STORAGE_VERSION, STORAGE_KEY)\n```\n\n---\n\n## Storage Patterns\n\n### For Small Data (Settings, Cache)\n```python\nfrom homeassistant.helpers.storage import Store\n\nSTORAGE_KEY = \"your_domain.storage\"\nSTORAGE_VERSION = 1\n\nstore = Store(hass, STORAGE_VERSION, STORAGE_KEY)\n\n# Save\ndata = {\"entities\": modified_entities}\nawait store.async_save(data)\n\n# Load\ndata = await store.async_load()\n```\n\n### For Large Data (History, Logs)\nUse external database or file storage, not HA storage helpers.\n\n---\n\n## Breaking Changes to Watch\n\n| Change | Version | Migration |\n|--------|---------|-----------|\n| Conversation agents | 2025.x+ | Use `async_process` directly |\n| Service response data | 2023.7+ | Add `supports_response` param |\n| Config entry migration | 2022.x+ | Use `async_migrate_entry` |\n\n**Always check:** https:\u002F\u002Fwww.home-assistant.io\u002Fblog\u002F for your target version range.\n\n---\n\n## HACS Integration Structure\n\n```\ncustom_components\u002Fyour_domain\u002F\n├── __init__.py          # async_setup_entry\n├── config_flow.py       # UI configuration\n├── manifest.json        # Dependencies, version\n├── services.yaml        # Service definitions\n└── storage_services.py  # Your storage logic\n```\n\n### Minimal manifest.json\n```json\n{\n  \"domain\": \"your_domain\",\n  \"name\": \"Your Integration\",\n  \"codeowners\": [\"@yourusername\"],\n  \"config_flow\": true,\n  \"dependencies\": [],\n  \"requirements\": [],\n  \"version\": \"1.0.0\"\n}\n```\n\n---\n\n## Testing Checklist\n\n- [ ] Service calls return expected data (with `?return_response`)\n- [ ] HTTP views accessible with auth token\n- [ ] No underscore-prefixed API usage\n- [ ] Storage persists across restarts\n- [ ] Config flow creates config entry\n- [ ] Error handling returns meaningful messages\n\n---\n\n## Documentation Resources\n\n- Integration basics: `developers.home-assistant.io\u002Fdocs\u002Fcreating_integration_index`\n- Service calls: `developers.home-assistant.io\u002Fdocs\u002Fdev_101_services`\n- HTTP views: `developers.home-assistant.io\u002Fdocs\u002Fapi\u002Fwebserver`\n- Breaking changes: `home-assistant.io\u002Fblog\u002F` (filter by version)\n- HACS guidelines: `hacs.xyz\u002Fdocs\u002Fpublish\u002Fstart`\n\n---\n\n## Lesson Learned\n\nFrom HA-OpenClaw Bridge attempt:\n\n> *\"80% of our issues were discoverable with 30-60 minutes of upfront docs reading. We jumped straight to coding based on assumptions rather than reading how HA actually works.\"*\n\nUse `skills\u002Fpre-coding-research\u002F` methodology before starting.\n",{"name":5,"description":7},"main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Fusimic\u002Fha-integration-patterns",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill ha-integration-patterns",{"tool":39,"command":40},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill ha-integration-patterns",{"tool":42,"command":43},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill ha-integration-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fusimic\u002Fha-integration-patterns\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],{"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},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\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},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\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},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\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},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\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},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]