{
  "markdown": "# dubbo-go-skills\n\n[English](README.md) | [中文](README_CN.md)\n\ndubbo-go-skills is a Claude Code plugin that gives your AI coding agent deep knowledge of [Apache dubbo-go](https://github.com/apache/dubbo-go) — the Go implementation of Apache Dubbo.\n\n## How it works\n\nWhen you're working with dubbo-go, your agent now knows what it's doing.\n\nAsk it to scaffold a new provider or consumer, and it picks the right code-API style (`dubbo.NewInstance` + `server.WithServerProtocol`), wires up the registry you're actually using, and produces something that compiles on first try. Need a custom filter or load balancer? It knows the SPI pattern — the exact `extension.SetXxx` call, the blank-import trick, and how to activate the extension per service or per reference. Integrating with a Java Dubbo service? It picks Triple+Protobuf or Dubbo+Hessian2 based on whether you have a `.proto` or a Java interface, and gets the POJO class names right.\n\nAsk why your service can't connect, and it walks through a structured checklist — registry, protocol match, serialization, filter chain — instead of guessing. Migrating from gRPC-Go or Spring Cloud? It maps the concepts one-for-one instead of making you guess.\n\nThe skills activate automatically when the context is right. You don't invoke them manually. Your agent just knows.\n\n> **Note:** All skills target dubbo-go **v3** only. v1 and v2 are deprecated.\n\n## Installation\n\n**Note:** Installation differs by platform. Claude Code and Cursor have built-in plugin marketplaces. Codex and OpenCode require manual setup.\n\n### Claude Code / Cursor\n\n```bash\n/plugin marketplace add Tsukikage7/dubbo-go-skills\n/plugin install dubbo-go@dubbo-go-skills\n```\n\n### Codex\n\nTell Codex:\n\n```\nFetch and follow instructions from https://raw.githubusercontent.com/Tsukikage7/dubbo-go-skills/main/.codex/INSTALL.md\n```\n\n**Detailed docs:** [.codex/INSTALL.md](.codex/INSTALL.md)\n\n### OpenCode\n\nAdd to your `opencode.json`:\n\n```json\n{\n  \"plugin\": [\"dubbo-go-skills@git+https://github.com/Tsukikage7/dubbo-go-skills.git\"]\n}\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/Tsukikage7/dubbo-go-skills\n```\n\nTo update:\n\n```bash\ngemini extensions update dubbo-go-skills\n```\n\n### Verify Installation\n\nStart a new session and say something like \"help me create a dubbo-go service\" or \"why is my provider not found\". The agent should automatically invoke the relevant skill.\n\n## Skills\n\n### scaffolding\n\nGenerates provider or consumer skeletons in the v3 code-API style (`dubbo.NewInstance` / `server.NewServer` / `client.NewClient`). Asks about protocol (Triple/Dubbo/gRPC) and registry (Nacos/ZooKeeper/etcd/direct) first, then produces a complete, compilable skeleton matching the official samples.\n\n### extensions\n\nGuide for writing custom SPI extensions — Filters, LoadBalancers, Registries, Protocols. Explains the uniform pattern (`extension.SetXxx` + blank import + `WithFilter`/`WithLoadBalance`), with a runnable template for each extension point and the common failure modes (name-string mismatch, missing blank import).\n\n### java-interop\n\nCross-language RPC between dubbo-go and dubbo-java. Helps you pick between Triple+Protobuf (new polyglot services) and Dubbo+Hessian2 (existing Java-defined services), get POJO class names right, and understand the HTTP route format Triple exposes for easy curl-based testing.\n\n### debug\n\nStructured diagnosis for runtime errors. Matches your error or log against known patterns — \"no provider available\", connection refused, serialization mismatch, timeout, filter panic — and gives you a targeted checklist to work through.\n\n### guide\n\nExplains dubbo-go architecture, extension points, and best practices. Covers core concepts (Instance, Protocol, Registry, Filter, Cluster, LoadBalance, Router) and the SPI pattern for writing custom extensions. Points to the relevant [dubbo-go-samples](https://github.com/apache/dubbo-go-samples) directory for each scenario.\n\n### migrate\n\nStep-by-step migration guidance from:\n- **gRPC-Go** — concept mapping, proto reuse, direct-mode equivalent\n- **Spring Cloud (Java)** — registry overlap, Java/Go interop path\n- **Gin / plain HTTP** — coexistence pattern and Triple REST mode\n- **dubbo-go v1/v2 → v3** — breaking changes table, minimal migration path\n\n## Contributing\n\nSkills live directly in this repository.\n\n1. Fork the repository\n2. Add or edit a skill in `skills/<name>/SKILL.md`\n3. Submit a PR\n\nThe goal is to eventually contribute this plugin to the Apache dubbo-go community.\n\n## Updating\n\n```bash\n/plugin update dubbo-go@dubbo-go-skills\n```\n\n## License\n\nApache License 2.0\n",
  "bytes": 4612,
  "sha": "0c9efddcfe6e0ac1e8f58a9c51f2183033d9bbf440fedd579f596e096859b442",
  "repo_slug": "tsukikage7/dubbo-go-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_tsukikage7_dubbo_go_skills_6472a7a0/readme"
}