{
  "markdown": "# Go Engineering Skills\n\nA focused collection of Agent Skills for production Go work. The repository uses a hybrid architecture: broad concerns are grouped into a small number of coherent skills, while detailed guidance lives in references loaded only when needed.\n\nThe collection is intentionally standard-library-first. It does not prescribe application frameworks, CLI libraries, assertion libraries, or vendor-specific packages.\n\n## Manual installation\n\nClone the repository once, then copy the desired skill directories from `skills/` into the discovery directory used by your agent. Copy the whole skill directory: `SKILL.md`, `references/`, `assets/`, and `agents/` belong together.\n\n```bash\ngit clone --depth 1 git@github.com:jkeddari/go-skills.git /tmp/go-skills\n```\n\n### Codex\n\nInstall globally for all projects:\n\n```bash\nmkdir -p ~/.codex/skills\ncp -R /tmp/go-skills/skills/. ~/.codex/skills/\n```\n\nOr install only for the current repository:\n\n```bash\nmkdir -p .codex/skills\ncp -R /tmp/go-skills/skills/. .codex/skills/\n```\n\n### Claude Code\n\n```bash\n# Global\nmkdir -p ~/.claude/skills\ncp -R /tmp/go-skills/skills/. ~/.claude/skills/\n\n# Or project-local\nmkdir -p .claude/skills\ncp -R /tmp/go-skills/skills/. .claude/skills/\n```\n\n### Cursor\n\n```bash\n# Global\nmkdir -p ~/.cursor/skills\ncp -R /tmp/go-skills/skills/. ~/.cursor/skills/\n\n# Or project-local\nmkdir -p .cursor/skills\ncp -R /tmp/go-skills/skills/. .cursor/skills/\n```\n\n### Gemini CLI\n\n```bash\n# Global\nmkdir -p ~/.gemini/skills\ncp -R /tmp/go-skills/skills/. ~/.gemini/skills/\n\n# Or project-local\nmkdir -p .gemini/skills\ncp -R /tmp/go-skills/skills/. .gemini/skills/\n```\n\n### Agent Skills-compatible agents\n\nAgents that discover the shared Agent Skills convention can use a project-local `.agents/skills/` directory:\n\n```bash\nmkdir -p .agents/skills\ncp -R /tmp/go-skills/skills/. .agents/skills/\n```\n\nTo install only one skill, replace `skills/.` in a command above with its directory, for example `skills/golang-testing`.\n\n## Plugin installation\n\nThis repository also includes plugin manifests for Claude Code, Cursor, Gemini CLI, and Codex. A plugin installation keeps the skill collection together and lets the agent discover the complete `skills/` directory.\n\n### Claude Code\n\nIn Claude Code, install the repository as a plugin:\n\n```text\n/plugin install https://github.com/jkeddari/go-skills\n```\n\nRestart Claude Code or begin a new conversation after installation.\n\n### Cursor\n\nOpen **Settings → Plugins**, choose the option to install a plugin from GitHub, then enter:\n\n```text\nhttps://github.com/jkeddari/go-skills\n```\n\nRestart Cursor or open a new agent conversation after the plugin is installed. If the plugin source option is unavailable in your Cursor build, use the manual `.cursor/skills/` installation above.\n\n### Gemini CLI\n\nInstall the repository extension:\n\n```bash\ngemini extensions install https://github.com/jkeddari/go-skills\n```\n\nStart a new Gemini CLI session after installation.\n\n### Codex\n\nThis repository is a Codex Git marketplace. Add it once, then install the plugin:\n\n```bash\ncodex plugin marketplace add jkeddari/go-skills --ref main\ncodex plugin add go-skills@go-skills\n```\n\nTo update the marketplace snapshot later, run:\n\n```bash\ncodex plugin marketplace upgrade go-skills\ncodex plugin add go-skills@go-skills\n```\n\nStart a new Codex conversation after installation or an update so that the skills are discovered. Use the manual `~/.codex/skills/` route above when you only need the skills and not the plugin packaging.\n\n## Architecture\n\nThe 14 skills are large enough to own a real engineering concern and small enough to trigger independently. Their `SKILL.md` files contain the operating workflow; detailed commands, examples, and edge cases are kept in `references/`.\n\n| Skill | Purpose |\n| --- | --- |\n| `golang-architecture` | Package boundaries, project layout, dependency direction, configuration, and manual dependency injection |\n| `golang-code-quality` | Idiomatic style, naming, errors, interfaces, data structures, and defensive coding |\n| `golang-concurrency` | Goroutines, channels, synchronization, pipelines, cancellation, and context propagation |\n| `golang-database` | `database/sql`, transactions, query safety, migrations, performance, and database tests |\n| `golang-dependencies` | Go modules, upgrades, vulnerability review, workspaces, and dependency conflicts |\n| `golang-gopls` | Language-server setup, navigation, diagnostics, refactoring, and editor integration |\n| `golang-observability` | Structured logging, metrics, tracing, profiling exposure, and actionable alerts |\n| `golang-performance` | Benchmark design, profiling, compiler diagnostics, optimization, and regression detection |\n| `golang-project` | Repository bootstrap, documentation, CI, releases, and maintenance files |\n| `golang-refactoring` | Behavior-preserving structural changes with explicit safety nets and validation |\n| `golang-security` | Threat-focused implementation, review, auditing, and secure defaults |\n| `golang-testing` | Standard-library unit, table-driven, integration, fuzz, race, and coverage workflows |\n| `golang-tooling` | Formatting, static analysis, linting, and Go-version modernization |\n| `golang-troubleshooting` | Reproduction, evidence collection, Delve, runtime diagnostics, pprof, and root-cause analysis |\n\nThe split is deliberate:\n\n- concerns with distinct triggers remain separate, such as testing, security, and performance;\n- closely coupled micro-skills are consolidated, such as naming, errors, and style under code quality;\n- detailed material is disclosed progressively instead of loading one monolithic Go manual;\n- framework- and vendor-specific skills are excluded.\n\n## Layout\n\n```text\nskills/<skill-name>/\n├── SKILL.md          # trigger metadata and focused workflow\n├── agents/openai.yaml # optional UI metadata\n├── references/       # deeper guidance loaded on demand\n└── assets/           # reusable configs and templates\n```\n\n## Contributing\n\nKeep every concept owned by one skill. Cross-reference the owning skill instead of duplicating instructions. Descriptions must state both what the skill covers and when it should trigger.\n\nBefore publishing changes, validate frontmatter, relative links, Markdown, and stale cross-references. Skill and plugin versions should be incremented deliberately as part of the release process.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n",
  "bytes": 6416,
  "sha": "52345d0062a140ad980d705eef5226ec281da8b652c78121a6ba262ab942ff70",
  "repo_slug": "jkeddari/go-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_jkeddari_go_skills_e1afdb64/readme"
}