colgen

A Go code generator that creates list types and helper methods for your structs from comments in collection.go. Go is a programming language, and the generated code can also convert values between package layers.

In plain words
What is it for?
Use it when maintaining collection.go, defining list types such as NewsList, or converting structs between packages and application layers.
Why use it?
It removes repetitive work when building collections, indexes, groups, counts, and relationships for Go structs. The source code stays focused on the data model while the generator creates the repeated helpers.

Skill for Claude CodeCodex

Part of the vmkteam-developer plugin — 35 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/vmkteam/claude-plugins/colgen
Any agent
npx skills add vmkteam/claude-plugins --skill colgen
Clone the repo
git clone --depth 1 https://github.com/vmkteam/claude-plugins

Made for: Claude Code, Codex.

Or install vmkteam-developer, the plugin that ships this one along with the rest of its 35 skills.

Per session 32 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,311 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00032 $0.01311
Opus 5 $0.00016 $0.00656
Sonnet 5 $0.00006 $0.00262
Haiku 4.5 $0.00003 $0.00131

Measured 2d ago against content hash 309b73c8525d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

colgen scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/developer/skills/colgen/SKILL.md · 110 lines

How it starts

The opening of the file, as written. The whole thing — 110 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Colgen

Upstream: https://github.com/vmkteam/colgen Docs: https://vmkteam.dev/colgen/

Генерирует коллекции (XxxList []Xxx) с утилитарными методами из директив в collection.go. Также: inline-сниппеты, LLM-режимы.

Директивы

  • //go:generate colgen — запуск генератора в файле
  • //colgen:News,Tag — базовая генерация типов + IDs() + Index() (если есть поле ID)
  • //colgen:News:<Method>[,<Method>...] — дополнительные методы
  • Код должен компилироваться перед запуском — парсинг через AST

Методы

Директива Эффект
NewsID NewsIDs() []int (если поле ID нестандартное)
Index(Field) IndexByField() map[T]News
UniqueField уникальные значения (поддерживает *T c nil-check)
Count(Field) CountByField(v) int
Group(Field) GroupByField() map[T]NewsList; для []T — fan-out
Fill(Target,Junction) заполняет связи; режим определяется типом junction
Cast(Interface) Interfaces() []Interface через pointer receiver
Map(pkg) / MapP(pkg) конструктор NewNewsList(in []pkg.News) NewsList
map/mapp то же в lowercase (приватный конструктор)

Поведение <Field> по типу

  • Скаляр StatusID intStatusIDs() []int
  • Слайс TagIDs []intflatten в []int (не [][]int)
  • Указатель Author *Author[]Author с nil-check и разыменованием

Fill — определение режима

Fill(Tags,TagIDs) где TagIDs []int → many-to-many через related.Index() + append Fill(Author,AuthorID) где AuthorID *int → one-to-one с nil-check Все FillXxx возвращают ll для чейнинга: news.FillTags(tags).FillAuthor(authors)

Map / MapP — конвертеры между слоями

//go:generate colgen -imports=newsportal/pkg/db
//colgen:News,Tag
//colgen:News:UniqueTagIDs,Map(db)

Требования:

  • Проект должен содержать дженерики Map[T,M] / MapP[T,M] (pointer-версия)
  • MapP(db) — если NewNews принимает *db.News
  • map/mapp (lowercase) — приватные конструкторы
  • Разное имя в db-слое: Map(db.News) (полный путь)
  • Структура не в базовой директиве → конструктор вернёт []News вместо NewsList
  • Другой пакет для Map/MapP: -funcpkg=<pkg> + имя пакета в -imports через запятую

Read the full file on GitHub · 110 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 110 lines · 32 tokens per session scan A 309b73c8525d

Subscribe to this mod's changes

colgen is a skill published in the GitHub repository vmkteam/claude-plugins (7 stars, last pushed 4mo ago), licensed MIT. It adds 32 tokens to every session and 1,311 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

layered-architecture-types

Enforce primitive-at-edges / strong-types-in-Business layering and the toBus/fromBusResponse/toDB converter pattern. Use when writing, editing, or auditing Go files under app/, business/domain/, or .../stores/db.

ardanlabs/service · 56 tokens

golang-testing

Production-ready Golang tests — table-driven tests, testify suites and mocks, parallel tests, fuzzing, fixtures, goroutine leak detection with goleak, snapshot testing, code coverage, integration tests, idiomatic test naming. Use when writing or reviewing Go tests, choosing a testing approach, setting up Go test CI…

samber/cc-skills-golang · 115 tokens

golang-observability

Golang everyday observability — the always-on signals in production. Covers structured logging with slog, Prometheus metrics, OpenTelemetry distributed tracing, continuous profiling with pprof/Pyroscope, server-side RUM event tracking, alerting, and Grafana dashboards. Apply when instrumenting Go services for…

samber/cc-skills-golang · 166 tokens

golang-data-structures

Golang data structures — slices (internals, capacity growth, preallocation, slices package), maps (internals, hash buckets, maps package), arrays, container/list/heap/ring, strings.Builder vs bytes.Buffer, generic collections, pointers (unsafe.Pointer, weak.Pointer), and copy semantics. Use when choosing or optimizing…

samber/cc-skills-golang · 126 tokens

golang-dependency-management

Dependency management for Golang projects — go.mod and go.sum, go get install and upgrade flows, Minimal Version Selection, conflict resolution with replace/exclude/retract, govulncheck scanning of the module tree, outdated dependency and binary size auditing, vendoring, tool directives, and go.work workspaces. Use…

samber/cc-skills-golang · 182 tokens

golang-spf13-viper

Golang configuration library using spf13/viper — layered precedence (flag > env > file > KV > default), BindPFlag/BindPFlags, SetEnvPrefix + SetEnvKeyReplacer + AutomaticEnv, ReadInConfig + ConfigFileNotFoundError, Unmarshal + mapstructure struct tags, Sub for sub-trees, WatchConfig + OnConfigChange for hot reload…

samber/cc-skills-golang · 174 tokens