Skip to content
Back to search

go-claude-skill

MarketplaceWorks with Claude CodeGitHub

Claude Code and Codex skill with Go service conventions: code style, required library stack and project layout

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/saturngfish--go-claude-skill/badge.svg)](/listings/saturngfish--go-claude-skill)

HTML

<a href="/listings/saturngfish--go-claude-skill"><img src="/api/listings/saturngfish--go-claude-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

In your shell:

claude plugin marketplace add saturngfish/go-claude-skill
claude plugin install go-service-conventions@go-claude-skill

Or inside a Claude Code session:

/plugin marketplace add saturngfish/go-claude-skill
/plugin install go-service-conventions@go-claude-skill

Codex

**As a plugin.** Add the marketplace, then install **Go Service Conventions** from the plugin directory (`/plugins` in the Codex CLI, or the Plugins page in the ChatGPT desktop app):

codex plugin marketplace add saturngfish/go-claude-skill

**As a plain skill, without plugins.** Copy the skill folder into your user skills directory and restart Codex:

git clone https://github.com/saturngfish/go-claude-skill
mkdir -p ~/.agents/skills
cp -r go-claude-skill/plugins/go-service-conventions/skills/go-service-conventions ~/.agents/skills/

To share it with everyone working in one repository instead, copy the folder into that repository's `.agents/skills/`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines
  1. {
  2. "name": "go-claude-skill",
  3. "description": "Claude Code and Codex skill with Go service conventions: code style, required library stack and project layout",
  4. "owner": {
  5. "name": "saturngfish"
  6. },
  7. "plugins": [
  8. {
  9. "name": "go-service-conventions",
  10. "displayName": "Go Service Conventions",
  11. "source": "./plugins/go-service-conventions",
  12. "description": "Go code style rules, the required library stack (GORM, NATS, Fiber v3, zerolog) and the service directory layout",
  13. "category": "development",
  14. "tags": ["go", "golang", "code-style", "conventions", "code-review", "project-structure", "gorm", "nats", "fiber"],
  15. "homepage": "https://github.com/saturngfish/go-claude-skill",
  16. "repository": "https://github.com/saturngfish/go-claude-skill"
  17. }
  18. ]
  19. }
README.md · README · 114 lines
  1. # go-claude-skill: Go conventions skill for Claude Code and Codex
  2. An agent skill, packaged as a plugin for Claude Code and OpenAI Codex, that teaches the agent a team's Go service conventions: code style, the required library stack (GORM, NATS, Fiber v3, zerolog, viper and others) and the project directory layout. Install it and the agent writes and reviews Go code by these rules.
  3. **Claude Code**
  4. ```bash
  5. claude plugin marketplace add saturngfish/go-claude-skill
  6. claude plugin install go-service-conventions@go-claude-skill
  7. ```
  8. **Codex**
  9. ```bash
  10. codex plugin marketplace add saturngfish/go-claude-skill
  11. ```
  12. Then install **Go Service Conventions** from the plugin directory. See [Install](#install) for the details and a no-plugin option.
  13. ## Why
  14. A coding agent writes valid Go by default, but not *our* Go. Without guidance it picks its own libraries, puts files wherever seems reasonable, and formats code in ways that fail review. Every such mismatch costs a review round or a manual fix.
  15. This skill puts the conventions where the agent reads them, so that generated and reviewed code already follows them:
  16. - **Fewer review comments.** Formatting rules (blank line before `return`, guard returns, logical blocks) are applied while the code is written.
  17. - **One stack across services.** The agent reaches for GORM, NATS, Fiber v3, zerolog and the rest of the agreed libraries instead of alternatives.
  18. - **Predictable project layout.** New code lands in the right directory (`internal/services`, `internal/repository`, `pkg/models`, ...), so every service looks the same.
  19. - **One source of truth.** The rules live in this repository, in a single `SKILL.md` shared by Claude Code and Codex. Update them here and everyone gets the change.
  20. ## What the skill covers
  21. | Area | Contents |
  22. |---|---|
  23. | Code formatting | Blank line before `return`, guard returns, separation of logical blocks, with good and bad examples |
  24. | Stack | Required library for each concern: database, transport, web server, validation, logging, config, JWT, Redis, Kafka, UUID, decimals |
  25. | Project layout | Purpose of every directory under `cmd`, `internal/` and `pkg/`, plus where each kind of code goes |
  26. | Review checklist | A short list the agent runs through when reviewing Go code |
  27. The full text is in [`plugins/go-service-conventions/skills/go-service-conventions/SKILL.md`](plugins/go-service-conventions/skills/go-service-conventions/SKILL.md).
  28. ## Install
  29. ### Claude Code
  30. In your shell:
  31. ```bash
  32. claude plugin marketplace add saturngfish/go-claude-skill
  33. claude plugin install go-service-conventions@go-claude-skill
  34. ```
  35. Or inside a Claude Code session:
  36. ```
  37. /plugin marketplace add saturngfish/go-claude-skill
  38. /plugin install go-service-conventions@go-claude-skill
  39. ```
  40. ### Codex
  41. **As a plugin.** Add the marketplace, then install **Go Service Conventions** from the plugin directory (`/plugins` in the Codex CLI, or the Plugins page in the ChatGPT desktop app):
  42. ```bash
  43. codex plugin marketplace add saturngfish/go-claude-skill
  44. ```
  45. **As a plain skill, without plugins.** Copy the skill folder into your user skills directory and restart Codex:
  46. ```bash
  47. git clone https://github.com/saturngfish/go-claude-skill
  48. mkdir -p ~/.agents/skills
  49. cp -r go-claude-skill/plugins/go-service-conventions/skills/go-service-conventions ~/.agents/skills/
  50. ```
  51. To share it with everyone working in one repository instead, copy the folder into that repository's `.agents/skills/`.
  52. ## Usage
  53. The agent loads the skill on its own when a task involves writing, editing, reviewing or scaffolding Go service code. To invoke it explicitly:
  54. | Agent | Explicit call |
  55. |---|---|
  56. | Claude Code | `/go-service-conventions:go-service-conventions` |
  57. | Codex | `$go-service-conventions` |
  58. Example prompts:
  59. - "Add a withdraw endpoint to this service."
  60. - "Review this PR against our Go conventions."
  61. - "Scaffold a new service called `payments`."
  62. ## Repository structure
  63. ```
  64. .claude-plugin/marketplace.json # Claude Code marketplace catalog
  65. .agents/plugins/marketplace.json # Codex marketplace catalog
  66. plugins/
  67. go-service-conventions/
  68. plugin.json # portable plugin manifest
  69. .claude-plugin/plugin.json # Claude Code manifest
  70. .codex-plugin/plugin.json # Codex manifest
  71. skills/go-service-conventions/
  72. SKILL.md # the conventions (shared by both agents)
  73. agents/openai.yaml # Codex display metadata
  74. ```
  75. ## Updating the rules
  76. 1. Edit `SKILL.md`.
  77. 2. Bump `version` in all three manifests: `plugin.json`, `.claude-plugin/plugin.json` and `.codex-plugin/plugin.json`.
  78. 3. Run `claude plugin validate --strict .` and push.
  79. Users pick up the new version with `claude plugin marketplace update go-claude-skill` (Claude Code) or `codex plugin marketplace upgrade` (Codex).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.