zero-skills
A skill that teaches an agent to build go-zero services: REST and RPC, goctl generation, databases, resilience and queues
- 91 ★ on the repository
- Last commit
Minimal access
Why this level
- The skill is instructions and references only, with read and search permissions
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/zero-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill is instructions and references only, with read and search permissions
This is third-party code. Review the repository files before installing.
What it does
The skill collects knowledge about the go-zero Go microservices framework in one directory: the agent reads it and writes code following project conventions. At its core is the three-layer architecture of Handler, Logic and Model, and the references in the `references` folder cover REST and RPC patterns, databases and collections, resilience, distributed transactions, message queues, observability and Swagger. `goctl` commands live in a separate file. There are folders with best practices, common troubleshooting, a demo project and a looklook case study. The `skill-patterns` folder holds ready agent scenarios for project analysis, service generation and architecture planning. Separate guides in `getting-started` explain setup for Claude Code, Codex, Cursor, GitHub Copilot and Windsurf.
Who it is for. Go developers who build or maintain microservices on go-zero and want the agent to know the framework conventions.
Good fit when
- You need a REST service generated from an `.api` file without breaking the three-layer project structure
- You must wire up a gRPC service, service discovery and middleware
- Requests fail under load and you need rate limiting and circuit breaker patterns
- The project already imports `github.com/zeromicro/go-zero` and review finds convention violations
Not a fit when
- The project runs on Gin, Echo or plain `net/http`: the skill knows go-zero only
- You need a reference for the Go language itself with no framework tie
- You are looking for a code generator: the skill only tells the agent the `goctl` commands and generates no code itself
Example request
Generate a go-zero service with login and registration from the user.api file and add token-checking middlewareLimitations
- The skill covers go-zero only: general Go code and other frameworks are out of scope.
- File access is limited to the `Read`, `Grep` and `Glob` permissions, so the skill runs nothing itself; the agent does that with your consent.
- Some material, such as the tool comparison in `getting-started`, describes third-party agent behavior and may age.
- `SKILL.md` declares the MIT license, but the repository license field on GitHub is empty.
How to disable. Delete the skill folder: `.claude/skills/zero-skills` in the project or `~/.claude/skills/zero-skills` in your personal directory.
FAQ
How do I install zero-skills in Claude Code?
Run `git clone https://github.com/zeromicro/zero-skills.git .claude/skills/zero-skills` in the project root, or clone into `~/.claude/skills/zero-skills` to use it in every project. You can also ask the agent to install zero-skills from the repository link.
When does the skill activate on its own?
When you ask to build, review or fix a go-zero service, mention `goctl`, open `.api` or `.proto` files or the project imports go-zero.
How is it different from goctl itself?
`goctl` generates code from an API description. The skill gives the agent knowledge: which command to call when, how the layers fit and what to do about typical errors.
Is there a Chinese version?
Yes, the repository includes `README_CN.md` with a Chinese description.
Which agents are supported?
Claude Code, OpenAI Codex, GitHub Copilot, Cursor and Windsurf. Each has its own guide in the `getting-started` folder.
Discussion
No questions or reviews yet.
Related
SkillsGo skills by samber
cc-skills-golang
Over forty Go skills: style, errors, concurrency, testing, security, performance and popular libraries
A set of Claude Code and Codex skills that teach the agent to write Spring Boot by your conventions and templates
A set of 14 skills for Java Spring Boot, from requirements analysis and code generation to tests, review and Docker deployment.
A skill for Claude Code and Codex on direct-style Scala: Ox structured concurrency, Tapir, error handling and configuration.
Skills for server-side Swift and the swift-server-lint linter: Swift NIO, Hummingbird, Postgres, concurrency and a lint hook.
Sixteen Spring Boot skills: the agent explores the application first, then edits JPA, DTOs, REST, Security, Kafka and tests.
README in short
The README explains what an agent skill is, why this one exists and how to install it, then shows the repository structure. Further sections cover working with different agents and link to the pattern references. A Chinese version and a verification script for the tutorial example are included.
README badge
Original SKILL.md
--- name: zero-skills description: Use when building, reviewing, or troubleshooting go-zero services, including REST and RPC code generation, middleware, service discovery, database models, collection data structures, resilience, observability, distributed transactions, and message queues. Trigger for goctl, .api or .proto files, or projects importing github.com/zeromicro/go-zero. version: 1.0.0 license: MIT allowed-tools: - Read - Grep - Glob --- # go-zero Skills for AI Agents This skill provides comprehensive go-zero microservices framework knowledge, optimized for AI agents helping developers build production-ready services. It covers REST APIs, RPC services, database operations, resilience patterns, high-performance data structures, and troubleshooting. ## 🎯 When to Use This Skill