CLI

Agent Skills

bkgo ships a SKILL.md that teaches AI coding agents (Claude Code, Cursor, Codex, etc.) how to work inside a bkgo project — so they drive changes through the CLI instead of hand-writing files that break the generated structure.


Install

Add the skill to your own project. It works with any agent that supports the Agent Skills format:

npx skills add BounkhongDev/bkgo

What it does

  • Inspects the current project structure before any structural change
  • Generates modules and layers with bkgo g module, never by hand
  • Follows the Hexagonal Architecture layer rules for every file it touches
  • Runs go fmt, go vet, and go test after making changes

When it activates

The skill triggers on any structural request — “add a user module”, “create a new service”, “remove the payment module”, “scaffold a new Go project” — even when you don't mention bkgo by name.


Layer rules it enforces

Every generated file stays in its lane:

  • No HTTP logic in domain.go — entities and interfaces only
  • No database code in domain.go — that belongs in repository.go
  • No business logic in handler.go — handlers call usecases, nothing more
  • No infrastructure imports in domain logic — usecases depend on interfaces
  • No renaming or deleting generated files without a clear reason