[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7A77JFCR9FCHNKW349P06WM":3,"skill-same:01M7A77JFCR9FCHNKW349P06WM":69},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":35,"updatedAt":36,"install":37,"resources":50},"01M7A77JFCR9FCHNKW349P06WM","golang-expert",null,"Complete Go development ecosystem: concurrent microservices with Gin, gRPC\u002FProtobuf communication, data access with GORM\u002Fpgx\u002Fexample.org, OpenTelemetry instrumentation, structured logging with Zap, table-driven testing and static analysis with golangci-lint. Use when writing Go microservices, creating gRPC\u002FProtobuf APIs, implementing data access with GORM\u002Fpgx, or setting up OpenTelemetry instrumentation. Trigger: Go microservice, gRPC Protobuf, GORM, pgx, OpenTelemetry Go, Zap logger, table-driven test, golangci-lint. Do NOT trigger for: general HTTP API design, database schema design, Dockerfile creation.","ronsilver\u002Fagent-covenant","ronsilver","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F46677526?v=4","01M7A719H1DVMZSKNAESAC82DA","Jorge Maturana","01M7A719J5GP33TM303CB8NN00",1,"MIT","https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Fgolang-expert\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: golang-expert\ndescription: \"Complete Go development ecosystem: concurrent microservices with Gin, gRPC\u002FProtobuf communication, data access with GORM\u002Fpgx\u002Fexample.org, OpenTelemetry instrumentation, structured logging with Zap, table-driven testing and static analysis with golangci-lint. Use when writing Go microservices, creating gRPC\u002FProtobuf APIs, implementing data access with GORM\u002Fpgx, or setting up OpenTelemetry instrumentation. Trigger: Go microservice, gRPC Protobuf, GORM, pgx, OpenTelemetry Go, Zap logger, table-driven test, golangci-lint. Do NOT trigger for: general HTTP API design, database schema design, Dockerfile creation.\"\nlicense: MIT\nmetadata:\n  author: Community\n  version: \"1.0\"\n  category: backend\n  status: stable\n---\n# Go Expert\n\n**Go ecosystem: microservices, gRPC, observability, testing and linting.**\n\n## Core Stack\n\n- HTTP: Gin (routing, middleware, validation)\n- RPC: gRPC + Protobuf (Buf, proto3, streaming)\n- Data: GORM + pgx + `example.org` libs (dynamodb, sqs, sns, auth, workflow, state-machine)\n- Internal: `go-kit` team (service interface, HTTP\u002FAMQP transports, middleware)\n- Logging: Zap (structured JSON)\n- Tracing: OpenTelemetry (traces, metrics, context propagation)\n- Testing: `go test` table-driven + Testify + benchmarks + race detector\n- Linting: `golangci-lint` (vet, staticcheck, gosec, errcheck)\n\n## Project Structure\n\n```\ncmd\u002Fserver\u002Fmain.go       # entry point, DI, graceful shutdown\ninternal\u002F\n  handler\u002F               # HTTP handlers (thin: parse -> call service -> return)\n  service\u002F               # business logic + OTel spans\n  repository\u002F            # data access (GORM\u002Fpgx)\n  model\u002F                 # domain types\n  middleware\u002F             # RequestID, logging, recovery, auth\napi\u002Fproto\u002F               # .proto files (Buf managed)\nmigrations\u002F              # SQL migration files\n```\n\n## Architecture\n\n```\nHandler -> Service -> Repository (NEVER skip layers)\n```\n\n- Handlers: thin, parse only, return status codes\n- Service: business logic + OTel spans (`tracer.Start(ctx, \"Op\")`)\n- Repository: data access with `context.Context`\n- ALWAYS propagate `context.Context` through all layers\n- NEVER business logic in handlers | NEVER repo from handler directly\n- ALWAYS `WithContext(ctx)` on GORM | ALWAYS wrap errors with `fmt.Errorf(\"op: %w\", err)`\n\n## gRPC \u002F Protobuf\n\n```protobuf\nsyntax = \"proto3\";\npackage resources.v1;\noption go_package = \"github.com\u002Fexample\u002Fresources\u002Fgen\u002Fgo\u002Fresources\u002Fv1;resourcesv1\";\n\nmessage ProcessRequest {\n  string resource_id = 1;\n  int64  quantity    = 2;  \u002F\u002F discrete = int64 units, NEVER float\n  string kind        = 3;\n}\n```\n\n- `buf lint` + `buf breaking --against .git#branch=main` before merge\n- Enums: ALWAYS `_UNSPECIFIED = 0` first value; never remove, mark reserved\n- Field numbers 1-15 for frequent fields (1-byte encoding)\n- Version packages as `service.v1`; bump to `v2` for breaking changes\n- Pagination: cursor-based with `page_token`, NEVER offset-based\n\n## OpenTelemetry\n\n- Span naming: `POST \u002Fresource` (never include IDs)\n- ALWAYS `span.RecordError(err)` on every error path\n- ALWAYS propagate `context.Context`; never create root spans mid-chain\n- Sampling: \u003C=10% in production (never 100%)\n- NEVER high-cardinality values as metric label keys\n\n## Linting (Golden Chain)\n\n```\ngo fmt -> golangci-lint run -> go vet -> go test -> gosec\n```\nStop on first failure. Never `|| true` in CI.\n\n## Libraries\n\n- `example.org`: 20+ sub-modules (core, http, dynamodb, aws, bindetector, auth, workflow, security, state-machine, validator, publisher, sns, sqs, notification-sender)\n- `go-kit`: toolkit HTTP\u002FAMQP, logging, tracing — 16+ dependent services\n- `goauth`: JWT integration helper\n- Changes to these libs have org-wide blast radius\n\n## Testing\n\n```go\nfunc TestProcessItem(t *testing.T) {\n    tests := []struct {\n        name    string\n        input   ItemRequest\n        want    ItemResponse\n        wantErr bool\n    }{{\n        name:    \"valid item\",\n        input:   ItemRequest{Value: 1000, Kind: \"standard\"},\n        want:    ItemResponse{Status: \"ok\"},\n        wantErr: false,\n    }}\n    for _, tt := range tests {\n        t.Run(tt.name, func(t *testing.T) {\n            got, err := svc.Process(t.Context(), tt.input)\n            if (err != nil) != tt.wantErr {\n                t.Errorf(\"error = %v, wantErr = %v\", err, tt.wantErr)\n            }\n        })\n    }\n}\n```\n- Table-driven tests always. Race detector: `go test -race .\u002F...`\n- Benchmarks for hot paths: `go test -bench=. -benchmem`\n\n## Constraints\n\n- NEVER business logic in handlers | NEVER repo from handler directly\n- NEVER expose internal errors to clients\n- NEVER reuse field numbers in proto | NEVER remove enum values\n- NEVER `float`\u002F`double` for discrete quantities — `int64` units\n- ALWAYS `context.Context` | ALWAYS `WithContext(ctx)` on GORM\n- ALWAYS wrap errors | ALWAYS structured logging with `trace_id`\n- ALWAYS graceful shutdown with `signal.NotifyContext`\n- NEVER `go fmt || true` — stop on lint failure\n- NEVER hardcode secrets — use env\u002Fconfig with secrets manager\n\n## Security\n\n- ALWAYS run `gosec` in CI and `govulncheck` for dependency CVEs (supply chain, OWASP A03)\n- NEVER allow SSRF (CWE-918): validate and allowlist all URLs passed to HTTP clients\n- NEVER deserialize untrusted bytes into structs (CWE-502) — decode with strict schemas only\n- ALWAYS pin direct and transitive dependencies; review `go mod graph` for drift\n\n## Overview\n\nGo microservices in this project use Gin for HTTP, gRPC+Protobuf for internal RPC, GORM\u002Fpgx for data access, and OpenTelemetry for observability. The `example.org` library suite provides shared infrastructure across 20+ services.\n\n## Quick Reference\n\n| Layer | Library | Responsibility |\n|---|---|---|\n| HTTP | Gin | Routing, middleware, validation |\n| RPC | gRPC + Protobuf (Buf) | Internal service-to-service communication |\n| Data | GORM + pgx + example.org | ORM, raw SQL, DynamoDB\u002FSQS\u002FSNS helpers |\n| Observability | OpenTelemetry + Zap | Traces, metrics, structured JSON logging |\n| Linting | golangci-lint (vet, staticcheck, gosec, errcheck) | Static analysis |\n\n## Workflow\n\n1. Define `.proto` service schema with `buf lint` + `buf breaking` check\n2. Generate Go code from protos and implement gRPC server\u002Fhandler\n3. Implement handler layer: parse request → call service → return response\n4. Implement service layer with business logic + OpenTelemetry spans\n5. Implement repository layer with `context.Context` and GORM `WithContext`\n6. Write table-driven tests with `go test -race .\u002F...`\n7. Run golden chain: `go fmt` → `golangci-lint run` → `go vet` → `go test` → `gosec`\n\n## Anti-patterns\n\nFAIL: Business logic in HTTP handlers\nPASS: Handlers only parse input; business logic in service layer\n\n```go\n\u002F\u002F FAIL:\nfunc (h *Handler) CreateItem(c *gin.Context) {\n    var req ItemRequest\n    if err := c.BindJSON(&req); err != nil { ... }\n    if req.Value \u003C= 0 { ... } \u002F\u002F business logic\n    result := h.db.Create(&Item{Value: req.Value}) \u002F\u002F data access\n    c.JSON(201, result)\n}\n\n\u002F\u002F PASS:\nfunc (h *Handler) CreateItem(c *gin.Context) {\n    var req ItemRequest\n    if err := c.BindJSON(&req); err != nil { ... }\n    result, err := h.svc.Process(c.Request.Context(), req)\n    if err != nil { ... }\n    c.JSON(201, result)\n}\n```\n\nFAIL: Using `float`\u002F`double` for discrete quantities\nPASS: Always use `int64` units\n\n```go\n\u002F\u002F FAIL:\ntype Item struct {\n    Value float64  \u002F\u002F floating point rounding errors\n}\n\n\u002F\u002F PASS:\ntype Item struct {\n    Value int64  \u002F\u002F use integer units\n}\n```\n\nFAIL: Silently swallowing errors with `|| true` in CI linting\nPASS: All linting steps must fail if any rule is violated\n\n```makefile\n# FAIL:\nlint:\n\tgo fmt || true\n\tgolangci-lint run || true\n\n# PASS:\nlint:\n\tgo fmt && golangci-lint run && go vet\n```\n\n## References\n\n- [Effective Go](https:\u002F\u002Fgo.dev\u002Fdoc\u002Feffective_go) (last_verified: 2026-05-25)\n- [gRPC Go Documentation](https:\u002F\u002Fgrpc.io\u002Fdocs\u002Flanguages\u002Fgo\u002F) (last_verified: 2026-05-25)\n- [OpenTelemetry Go](https:\u002F\u002Fopentelemetry.io\u002Fdocs\u002Flanguages\u002Fgo\u002F) (last_verified: 2026-05-25)\n\n- [references\u002Fconcurrency.md](references\u002Fconcurrency.md)\n- [references\u002Fperformance.md](references\u002Fperformance.md)\n- [references\u002Ftesting.md](references\u002Ftesting.md)\n\n## Verification Checklist\n\n- [ ] Handler layer is thin (parse request → call service → return response, no business logic)\n- [ ] `context.Context` propagated through all layers (handler → service → repository)\n- [ ] Discrete quantities use `int64` units (never float\u002Fdouble)\n- [ ] gRPC protos pass `buf lint` and `buf breaking` checks\n- [ ] OpenTelemetry spans created with `RecordError` on all error paths\n- [ ] Table-driven tests written with `go test -race .\u002F...` passing\n- [ ] `gosec` and `govulncheck` run clean in CI (no HIGH\u002FCritical findings)\n\n## Troubleshooting\n\n| Symptom | Likely cause | Fix |\n|---|---|---|\n| `sql: database is closed` | Missing `WithContext(ctx)` on GORM call | Ensure every GORM query uses `db.WithContext(ctx)` |\n| gRPC `Unavailable` error | Server not registered or port mismatch | Verify `grpcServer.Serve(lis)` called with correct listener address |\n| Traces not appearing in backend | Missing OTel exporter or incorrect endpoint | Check `OTEL_EXPORTER_OTLP_ENDPOINT` env var and service name in SDK init |\n| Edge case: `go test -race` false positive on atomic operations | Race detector flags intentional concurrent access patterns | Use `sync\u002Fatomic` for counters; mark deliberate races with `\u002F\u002Fnolint:race` comment |\n\n| [WARN] go-kit endpoint panics on nil request | Endpoint `DecodeRequestFunc` returns nil if decoding fails; transport sends nil to endpoint | Check `req != nil` in endpoint before passing to `next`; always wrap decode with error return |\n| go.mod indirect dependency pinned to broken version by a team internal module | team internal example.org module pins a vulnerable transitive dep that cannot be upgraded | Add replace directive in go.mod; request the owning team to update their dependency version |\n| Known bug: go-kit logging middleware drops context fields when logger is passed by value | go-kit logger interface used with value receiver; context fields lost between middleware layers | Always pass *log.Logger pointer; verify context fields survive middleware chain |\n","# Go Expert\n\n**Go ecosystem: microservices, gRPC, observability, testing and linting.**\n\n## Core Stack\n\n- HTTP: Gin (routing, middleware, validation)\n- RPC: gRPC + Protobuf (Buf, proto3, streaming)\n- Data: GORM + pgx + `example.org` libs (dynamodb, sqs, sns, auth, workflow, state-machine)\n- Internal: `go-kit` team (service interface, HTTP\u002FAMQP transports, middleware)\n- Logging: Zap (structured JSON)\n- Tracing: OpenTelemetry (traces, metrics, context propagation)\n- Testing: `go test` table-driven + Testify + benchmarks + race detector\n- Linting: `golangci-lint` (vet, staticcheck, gosec, errcheck)\n\n## Project Structure\n\n```\ncmd\u002Fserver\u002Fmain.go       # entry point, DI, graceful shutdown\ninternal\u002F\n  handler\u002F               # HTTP handlers (thin: parse -> call service -> return)\n  service\u002F               # business logic + OTel spans\n  repository\u002F            # data access (GORM\u002Fpgx)\n  model\u002F                 # domain types\n  middleware\u002F             # RequestID, logging, recovery, auth\napi\u002Fproto\u002F               # .proto files (Buf managed)\nmigrations\u002F              # SQL migration files\n```\n\n## Architecture\n\n```\nHandler -> Service -> Repository (NEVER skip layers)\n```\n\n- Handlers: thin, parse only, return status codes\n- Service: business logic + OTel spans (`tracer.Start(ctx, \"Op\")`)\n- Repository: data access with `context.Context`\n- ALWAYS propagate `context.Context` through all layers\n- NEVER business logic in handlers | NEVER repo from handler directly\n- ALWAYS `WithContext(ctx)` on GORM | ALWAYS wrap errors with `fmt.Errorf(\"op: %w\", err)`\n\n## gRPC \u002F Protobuf\n\n```protobuf\nsyntax = \"proto3\";\npackage resources.v1;\noption go_package = \"github.com\u002Fexample\u002Fresources\u002Fgen\u002Fgo\u002Fresources\u002Fv1;resourcesv1\";\n\nmessage ProcessRequest {\n  string resource_id = 1;\n  int64  quantity    = 2;  \u002F\u002F discrete = int64 units, NEVER float\n  string kind        = 3;\n}\n```\n\n- `buf lint` + `buf breaking --against .git#branch=main` before merge\n- Enums: ALWAYS `_UNSPECIFIED = 0` first value; never remove, mark reserved\n- Field numbers 1-15 for frequent fields (1-byte encoding)\n- Version packages as `service.v1`; bump to `v2` for breaking changes\n- Pagination: cursor-based with `page_token`, NEVER offset-based\n\n## OpenTelemetry\n\n- Span naming: `POST \u002Fresource` (never include IDs)\n- ALWAYS `span.RecordError(err)` on every error path\n- ALWAYS propagate `context.Context`; never create root spans mid-chain\n- Sampling: \u003C=10% in production (never 100%)\n- NEVER high-cardinality values as metric label keys\n\n## Linting (Golden Chain)\n\n```\ngo fmt -> golangci-lint run -> go vet -> go test -> gosec\n```\nStop on first failure. Never `|| true` in CI.\n\n## Libraries\n\n- `example.org`: 20+ sub-modules (core, http, dynamodb, aws, bindetector, auth, workflow, security, state-machine, validator, publisher, sns, sqs, notification-sender)\n- `go-kit`: toolkit HTTP\u002FAMQP, logging, tracing — 16+ dependent services\n- `goauth`: JWT integration helper\n- Changes to these libs have org-wide blast radius\n\n## Testing\n\n```go\nfunc TestProcessItem(t *testing.T) {\n    tests := []struct {\n        name    string\n        input   ItemRequest\n        want    ItemResponse\n        wantErr bool\n    }{{\n        name:    \"valid item\",\n        input:   ItemRequest{Value: 1000, Kind: \"standard\"},\n        want:    ItemResponse{Status: \"ok\"},\n        wantErr: false,\n    }}\n    for _, tt := range tests {\n        t.Run(tt.name, func(t *testing.T) {\n            got, err := svc.Process(t.Context(), tt.input)\n            if (err != nil) != tt.wantErr {\n                t.Errorf(\"error = %v, wantErr = %v\", err, tt.wantErr)\n            }\n        })\n    }\n}\n```\n- Table-driven tests always. Race detector: `go test -race .\u002F...`\n- Benchmarks for hot paths: `go test -bench=. -benchmem`\n\n## Constraints\n\n- NEVER business logic in handlers | NEVER repo from handler directly\n- NEVER expose internal errors to clients\n- NEVER reuse field numbers in proto | NEVER remove enum values\n- NEVER `float`\u002F`double` for discrete quantities — `int64` units\n- ALWAYS `context.Context` | ALWAYS `WithContext(ctx)` on GORM\n- ALWAYS wrap errors | ALWAYS structured logging with `trace_id`\n- ALWAYS graceful shutdown with `signal.NotifyContext`\n- NEVER `go fmt || true` — stop on lint failure\n- NEVER hardcode secrets — use env\u002Fconfig with secrets manager\n\n## Security\n\n- ALWAYS run `gosec` in CI and `govulncheck` for dependency CVEs (supply chain, OWASP A03)\n- NEVER allow SSRF (CWE-918): validate and allowlist all URLs passed to HTTP clients\n- NEVER deserialize untrusted bytes into structs (CWE-502) — decode with strict schemas only\n- ALWAYS pin direct and transitive dependencies; review `go mod graph` for drift\n\n## Overview\n\nGo microservices in this project use Gin for HTTP, gRPC+Protobuf for internal RPC, GORM\u002Fpgx for data access, and OpenTelemetry for observability. The `example.org` library suite provides shared infrastructure across 20+ services.\n\n## Quick Reference\n\n| Layer | Library | Responsibility |\n|---|---|---|\n| HTTP | Gin | Routing, middleware, validation |\n| RPC | gRPC + Protobuf (Buf) | Internal service-to-service communication |\n| Data | GORM + pgx + example.org | ORM, raw SQL, DynamoDB\u002FSQS\u002FSNS helpers |\n| Observability | OpenTelemetry + Zap | Traces, metrics, structured JSON logging |\n| Linting | golangci-lint (vet, staticcheck, gosec, errcheck) | Static analysis |\n\n## Workflow\n\n1. Define `.proto` service schema with `buf lint` + `buf breaking` check\n2. Generate Go code from protos and implement gRPC server\u002Fhandler\n3. Implement handler layer: parse request → call service → return response\n4. Implement service layer with business logic + OpenTelemetry spans\n5. Implement repository layer with `context.Context` and GORM `WithContext`\n6. Write table-driven tests with `go test -race .\u002F...`\n7. Run golden chain: `go fmt` → `golangci-lint run` → `go vet` → `go test` → `gosec`\n\n## Anti-patterns\n\nFAIL: Business logic in HTTP handlers\nPASS: Handlers only parse input; business logic in service layer\n\n```go\n\u002F\u002F FAIL:\nfunc (h *Handler) CreateItem(c *gin.Context) {\n    var req ItemRequest\n    if err := c.BindJSON(&req); err != nil { ... }\n    if req.Value \u003C= 0 { ... } \u002F\u002F business logic\n    result := h.db.Create(&Item{Value: req.Value}) \u002F\u002F data access\n    c.JSON(201, result)\n}\n\n\u002F\u002F PASS:\nfunc (h *Handler) CreateItem(c *gin.Context) {\n    var req ItemRequest\n    if err := c.BindJSON(&req); err != nil { ... }\n    result, err := h.svc.Process(c.Request.Context(), req)\n    if err != nil { ... }\n    c.JSON(201, result)\n}\n```\n\nFAIL: Using `float`\u002F`double` for discrete quantities\nPASS: Always use `int64` units\n\n```go\n\u002F\u002F FAIL:\ntype Item struct {\n    Value float64  \u002F\u002F floating point rounding errors\n}\n\n\u002F\u002F PASS:\ntype Item struct {\n    Value int64  \u002F\u002F use integer units\n}\n```\n\nFAIL: Silently swallowing errors with `|| true` in CI linting\nPASS: All linting steps must fail if any rule is violated\n\n```makefile\n# FAIL:\nlint:\n\tgo fmt || true\n\tgolangci-lint run || true\n\n# PASS:\nlint:\n\tgo fmt && golangci-lint run && go vet\n```\n\n## References\n\n- [Effective Go](https:\u002F\u002Fgo.dev\u002Fdoc\u002Feffective_go) (last_verified: 2026-05-25)\n- [gRPC Go Documentation](https:\u002F\u002Fgrpc.io\u002Fdocs\u002Flanguages\u002Fgo\u002F) (last_verified: 2026-05-25)\n- [OpenTelemetry Go](https:\u002F\u002Fopentelemetry.io\u002Fdocs\u002Flanguages\u002Fgo\u002F) (last_verified: 2026-05-25)\n\n- [references\u002Fconcurrency.md](references\u002Fconcurrency.md)\n- [references\u002Fperformance.md](references\u002Fperformance.md)\n- [references\u002Ftesting.md](references\u002Ftesting.md)\n\n## Verification Checklist\n\n- [ ] Handler layer is thin (parse request → call service → return response, no business logic)\n- [ ] `context.Context` propagated through all layers (handler → service → repository)\n- [ ] Discrete quantities use `int64` units (never float\u002Fdouble)\n- [ ] gRPC protos pass `buf lint` and `buf breaking` checks\n- [ ] OpenTelemetry spans created with `RecordError` on all error paths\n- [ ] Table-driven tests written with `go test -race .\u002F...` passing\n- [ ] `gosec` and `govulncheck` run clean in CI (no HIGH\u002FCritical findings)\n\n## Troubleshooting\n\n| Symptom | Likely cause | Fix |\n|---|---|---|\n| `sql: database is closed` | Missing `WithContext(ctx)` on GORM call | Ensure every GORM query uses `db.WithContext(ctx)` |\n| gRPC `Unavailable` error | Server not registered or port mismatch | Verify `grpcServer.Serve(lis)` called with correct listener address |\n| Traces not appearing in backend | Missing OTel exporter or incorrect endpoint | Check `OTEL_EXPORTER_OTLP_ENDPOINT` env var and service name in SDK init |\n| Edge case: `go test -race` false positive on atomic operations | Race detector flags intentional concurrent access patterns | Use `sync\u002Fatomic` for counters; mark deliberate races with `\u002F\u002Fnolint:race` comment |\n\n| [WARN] go-kit endpoint panics on nil request | Endpoint `DecodeRequestFunc` returns nil if decoding fails; transport sends nil to endpoint | Check `req != nil` in endpoint before passing to `next`; always wrap decode with error return |\n| go.mod indirect dependency pinned to broken version by a team internal module | team internal example.org module pins a vulnerable transitive dep that cannot be upgraded | Add replace directive in go.mod; request the owning team to update their dependency version |\n| Known bug: go-kit logging middleware drops context fields when logger is passed by value | go-kit logger interface used with value receiver; context fields lost between middleware layers | Always pass *log.Logger pointer; verify context fields survive middleware chain |\n",{"name":5,"license":15,"metadata":24,"description":7},{"author":25,"status":26,"version":27,"category":28},"Community","stable","1.0","backend","main","6692ee5cbe39d4533b824e1c55d7d4fc01c4dde7","content\u002Fskills\u002Fgolang-expert",0,"https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant","https:\u002F\u002Fgithub.com\u002Fronsilver",":v","2026-08-27 05:49:26",{"source":8,"skillName":5,"commands":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add ronsilver\u002Fagent-covenant --skill golang-expert",{"tool":43,"command":44},"bunx","bunx skills add ronsilver\u002Fagent-covenant --skill golang-expert",{"tool":46,"command":47},"pnpm","pnpm dlx skills add ronsilver\u002Fagent-covenant --skill golang-expert","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Fgolang-expert\u002FSKILL.md",true,[51,57,61,65],{"path":52,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":55,"sourceHtmlUrl":56},"evals\u002Fevals.json","REFERENCE","参考文档",2410,"https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Fgolang-expert\u002Fevals\u002Fevals.json",{"path":58,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Fconcurrency.md",1628,"https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Fgolang-expert\u002Freferences\u002Fconcurrency.md",{"path":62,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fperformance.md",1217,"https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Fgolang-expert\u002Freferences\u002Fperformance.md",{"path":66,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Ftesting.md",1886,"https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Fgolang-expert\u002Freferences\u002Ftesting.md",[70,77,84,91,98,105],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7A7HYVYNZ60GNGWAV51ZQ52","web-browsing-agent-expert","Web browsing for AI agents: driving a headless browser (Playwright, Puppeteer) from agent tooling, navigation and page-state grounding, DOM extraction and structured data capture, form interaction, session and cookie management, anti-bot mitigation awareness, and safe browsing rules (no PII exfiltration, respect robots and terms). Use when building a browsing tool or MCP server for an agent, teaching an agent to navigate and read web pages, extracting structured content from dynamic sites, or handling login walls and pagination in agent workflows. Trigger: web browsing agent, headless browser, Playwright MCP, Puppeteer, browser automation for agents, DOM extraction, page navigation, session management. Do NOT trigger for: end-to-end UI testing of an application (use playwright-expert); writing standalone scraping scripts for data pipelines (use python-expert); fetching a single public URL (use the fetch tool).","https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Fweb-browsing-agent-expert\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7A7HRC6951BAJ9NHBZA2M7Y","vector-databases","Design and operate vector databases for cloud-native AI features. Use when selecting between pgvector, Pinecone, or Weaviate for AI context layer or integration-hub; designing embedding schemas and index parameters; implementing ANN search with metadata filtering; managing embedding model versions; optimizing query latency; or debugging low retrieval quality. Pairs with rag-architecture for pipeline design and postgres-database-expert for pgvector specifics. Trigger: vector database, pgvector, Pinecone, Weaviate, embedding, ANN search, HNSW, cosine similarity. Do NOT trigger for: relational SQL optimization, standard PostgreSQL schema design, Redis caching.","https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Fvector-databases\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7A7HGHGWE7NZ5A08HQZJXDN","typescript-expert","Full-stack TypeScript stack for modern projects: frontend SSR\u002FCSR with Next.js 14 App Router and React, backend APIs with Node.js (Express\u002FFastify), state management with Zustand\u002FRedux Toolkit, unit and integration testing with Vitest\u002FJest + React Testing Library + MSW, and static analysis with ESLint\u002FPrettier\u002Ftsc. Use when building React components or hooks, implementing Next.js App Router or Server Components, writing Node.js REST API handlers, implementing middleware (auth, rate-limit, logging), managing client state (Zustand\u002FRTK), writing frontend\u002Fbackend tests, or running TypeScript linting\u002Ftype checks. Trigger: TypeScript, Next.js, React, Zustand, Node.js, Express, Fastify, MSW, Vitest. Do NOT trigger for: Python backend development, Go microservices, iOS\u002Fmobile development.","https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Ftypescript-expert\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M7A7H83JK9SENNYAPTTB6B4A","tool-usage","Guide correct tool selection, design, and orchestration for AI agents. Use when choosing between dedicated vs Bash tools, designing MCP tool interfaces, naming tool parameters, handling tool response limits, orchestrating parallel vs sequential calls, evaluating tool accuracy, applying ACI design principles, selecting workflow patterns, or reading\u002Ffiltering\u002Ftransforming\u002Fgenerating structured data (JSON, YAML, CSV, TOML, XML). Trigger: tool selection, MCP tool design, orchestration, ACI, parallel execution, composite tool, structured data, jq, yq, dasel, mlr, csvkit. Do NOT trigger for: writing application business logic, domain-specific development (route to domain skill), database migrations.","https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Ftool-usage\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M7A7GZ9A2VA9T7BJ07VV3PD5","token-efficiency","Enforce token-efficient output, compression, caching, and model routing. Use when calibrating response verbosity, applying compression strategies to logs or RAG chunks, routing tasks to the right model tier, setting thinking budgets, enforcing word limits, compressing context before reinitiation, applying KV-cache ordering, masking tool output observations, or applying clarification-first protocol before irreversible actions. Trigger: token efficiency, compression, model routing, thinking budget, KV-cache, clarification protocol. Do NOT trigger for: non-agent tooling, CI\u002FCD pipeline scripting, infrastructure provisioning.","https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Ftoken-efficiency\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":19},"01M7A7GQFTY8GWVN4Z66Q4J52V","time-series-db","Time-series database patterns for cloud-native metrics and analytics: TimescaleDB, InfluxDB, and Amazon Timestream selection; continuous aggregates, retention policies, downsampling, and integration with Prometheus\u002FGrafana. Use when storing business metrics over time, building custom business dashboards, designing high-frequency event storage, or querying time-bucketed aggregations. Trigger: time-series, TimescaleDB, InfluxDB, Prometheus, Grafana, hypertable, continuous aggregate, retention policy. Do NOT trigger for: relational PostgreSQL schema design, NoSQL document stores, Kafka event streaming.","https:\u002F\u002Fgithub.com\u002Fronsilver\u002Fagent-covenant\u002Fblob\u002Fmain\u002Fcontent\u002Fskills\u002Ftime-series-db\u002FSKILL.md",[],[]]