Setting the skill. One moment.
Skills
Skill 3 of 54
Use Go struct tags to render styled terminal output in gh-aw.
1 minute · 171 words · 13 sections
Install
npx skills add github/gh-aw --skill console-renderingnpx skills add github/gh-awThe first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.
Use this guide for the struct tag-based console rendering system.
Use the console struct tag to control rendering behavior:
header:"Name" - Sets the display name for fields (used in both structs and tables)title:"Section Title" - Sets the title for nested structs, slices, or mapsformat:"type" - Sets the formatting type for the field value
format:number - Formats integers as human-readable numbers (e.g., “1k”, “1.2M”)format:cost - Formats floats as currency with $ prefix (e.g., “$1.234”)omitempty - Skips the field if it has a zero value"-" - Always skips the fieldtype Overview struct {
RunID int64 `console:"header:Run ID"`
Workflow string `console:"header:Workflow"`
Status string `console:"header:Status"`
Duration string `console:"header:Duration,omitempty"`
}
data := Overview{
RunID: 12345,
Workflow: "test-workflow",
Status: "completed",
Duration: "5m30s",
}
// Simple rendering
fmt.Print(console.RenderStruct(data))
// Output:
// Run ID : 12345
// Workflow: test-workflow
// Status : completed
// Duration: 5m30stype Metrics struct {
TokenUsage int `console:"header:Token Usage,format:number"`
Errors int `console:"header:Errors"`
}
data := Metrics{
TokenUsage: 250000,
Errors: 5,
}
// Renders as:
// Token Usage: 250k
// Errors : 5type Billing struct {
Cost float64 `console:"header:Estimated Cost,format:cost"`
}
data := Billing{
Cost: 1.234,
}
// Renders as:
// Estimated Cost: $1.234Structs are rendered as key-value pairs with proper alignment.
Slices of structs are automatically rendered as tables:
type Job struct {
Name string `console:"header:Name"`
Status string `console:"header:Status"`
Conclusion string `console:"header:Conclusion,omitempty"`
}
jobs := []Job{
{Name: "build", Status: "completed", Conclusion: "success"},
{Name: "test", Status: "in_progress", Conclusion: ""},
}
fmt.Print(console.RenderStruct(jobs))Renders as:
Name | Status | Conclusion
----- | ----------- | ----------
build | completed | success
test | in_progress | -Maps are rendered as markdown-style headers with key-value pairs.
time.Time fields are automatically formatted as "2006-01-02 15:04:05". Zero time values are considered empty when used with omitempty.
The rendering system safely handles unexported struct fields by checking CanInterface() before attempting to access field values.
main, last pushed 24 September 2026.SKILL.md, not by matching a directory convention. 4 distinct layouts observed: .claude/skills/*/SKILL.md, .github/skills/*/SKILL.md, .squad/*/skill.md, SKILL.md (repo root).h1 and no skipped levels:/github/gh-aw.md, and each skill at its own .md URL.