{
  "markdown": "# Golang DDD Skills\n\nThese are AI coding agent skills for Go services.\n\nThey are mainly about:\n\n- service architecture,\n- domain-oriented refactoring,\n- pragmatic CQRS,\n- testing and delivery setup.\n\n> [!IMPORTANT]\n> This is an unofficial skill pack inspired by public material from Three Dots Labs, especially [Go With The Domain](https://threedots.tech/go-with-the-domain/).\n> It is not affiliated with or endorsed by Three Dots Labs.\n>\n> The goal here is not to reproduce the book. The goal is to turn similar ideas into reusable prompts and decision rules for coding agents.\n\n## What these skills do\n\n| Skill | Role | Use when |\n| --- | --- | --- |\n| `golang-ddd` | Router skill | You want one entry point that chooses the right DDD-oriented workflow for the task. |\n| `golang-ddd-architecture` | Architecture and boundaries | You need clearer ports/app/domain/adapters separation, better dependency direction, or model boundaries. |\n| `golang-ddd-refactor` | Domain-first refactoring | Business rules are hiding in handlers, repositories, or mutable structs. |\n| `golang-ddd-cqrs` | Pragmatic CQRS | Read and write concerns are mixed and application services are getting too wide. |\n| `golang-ddd-infrastructure` | Infra, testing, delivery | CI, Terraform, auth, and test strategy need to reinforce the architecture instead of fighting it. |\n\nIf you know the book already, the style will probably feel familiar.\n\n## Why keep them together\n\nThese skills work better as one pack:\n\n- `golang-ddd` routes tasks to the right specialization.\n- The companion skills use the same vocabulary for layers, invariants, handlers, repositories, and composition roots.\n- You can install just one or two, but keeping them on the same version is simpler.\n\n## Repository layout\n\n```text\ngolang-ddd-skills/\n├── skills/\n│   ├── golang-ddd/\n│   ├── golang-ddd-architecture/\n│   ├── golang-ddd-refactor/\n│   ├── golang-ddd-cqrs/\n│   └── golang-ddd-infrastructure/\n├── .claude-plugin/\n├── .cursor-plugin/\n├── .github/workflows/\n├── scripts/\n├── gemini-extension.json\n├── VERSION\n└── CHANGELOG.md\n```\n\n## Supported agents\n\nThis repo is laid out so the same `skills/` directory can be used by several tools.\n\n| Agent | Install style | Notes |\n| --- | --- | --- |\n| Codex / OpenAI Codex CLI | Git clone into `~/.agents/skills/` | Uses the shared cross-client skills directory. |\n| OpenCode | Git clone into `~/.agents/skills/` | Same layout as Codex. |\n| Gemini CLI | `gemini extensions install` | Uses `gemini-extension.json`. |\n| Cursor | Git clone into `~/.cursor/skills/` | Uses `.cursor-plugin/plugin.json` plus the shared `skills/` folder. |\n| Claude Code | Plugin-compatible repository | Uses `.claude-plugin/plugin.json`. |\n| Any Agent Skills-compatible tool | `npx skills add` | Uses the top-level `skills/` directory. |\n\n## Installation\n\n### Universal Agent Skills install\n\nIf your tool supports the Agent Skills ecosystem, install directly from GitHub:\n\n```bash\nnpx skills add https://github.com/joeyave/golang-ddd-skills --all\n```\n\nTo install just one skill:\n\n```bash\nnpx skills add https://github.com/joeyave/golang-ddd-skills --skill golang-ddd\n```\n\n### Codex / OpenAI Codex CLI\n\nClone the repository into a discovered skills directory:\n\n```bash\ngit clone https://github.com/joeyave/golang-ddd-skills.git ~/.agents/skills/golang-ddd-skills\n```\n\nCodex discovers skills from `~/.agents/skills/` and workspace-local `.agents/skills/`.\n\n### OpenCode\n\nClone into a shared skills directory:\n\n```bash\ngit clone https://github.com/joeyave/golang-ddd-skills.git ~/.agents/skills/golang-ddd-skills\n```\n\n### Gemini CLI\n\nThis repository includes `gemini-extension.json`, so it can be installed as an extension:\n\n```bash\ngemini extensions install https://github.com/joeyave/golang-ddd-skills\n```\n\n### Cursor\n\nThis repository includes `.cursor-plugin/plugin.json`. Clone it into a Cursor-discovered skills path:\n\n```bash\ngit clone https://github.com/joeyave/golang-ddd-skills.git ~/.cursor/skills/golang-ddd-skills\n```\n\n### Claude Code\n\nThis repository includes `.claude-plugin/plugin.json`.\n\n## Compatibility notes\n\n- Skill descriptions are quoted in YAML frontmatter for safer parsing across importers.\n- Each skill includes `metadata.version`, so the repository version can be mirrored into individual skills.\n- Existing `agents/openai.yaml` files are preserved for OpenAI-family tooling.\n- The top-level `skills/` directory follows the same cross-client convention used by repos such as [`samber/cc-skills-golang`](https://github.com/samber/cc-skills-golang).\n- `./scripts/validate-pack.sh` is the single validation entry point for local checks and GitHub Actions.\n\n## Versioning\n\nThis repository uses Semantic Versioning.\n\n- `MAJOR`: breaking changes to skill names, install layout, routing behavior, or compatibility metadata.\n- `MINOR`: new skills, substantial new guidance, new supported clients, or stronger repository automation.\n- `PATCH`: wording fixes, trigger tuning, metadata corrections, and small non-breaking edits.\n\nThe canonical version lives in [`VERSION`](./VERSION).\n\nFor reproducible installs, prefer Git tags such as `v0.2.0` after publishing. Clone-based installs can pin a release with `git checkout v0.2.0`.\n\nMaintainer release steps live in [MAINTAINING.md](./MAINTAINING.md).\n\n## Acknowledgements\n\nThis pack was inspired by public writing from Three Dots Labs, especially [Go With The Domain](https://threedots.tech/go-with-the-domain/).\n\nIt is a separate, unofficial project.\n\n## License\n\nThis repository is released under the MIT license. See [LICENSE](./LICENSE).\n",
  "bytes": 5576,
  "sha": "d578fbaf11180699a47569b0569e914620fc01df99429ba78d6dffd5873a80ae",
  "repo_slug": "joeyave/golang-ddd-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_joeyave_golang_ddd_skills_997b7136/readme"
}