Entgo Skills

Entgo Skills for AI Agents

This skill provides comprehensive entgo entity framework knowledge, optimized for AI agents helping developers build production-ready Go applications with type-safe database operations.

🎯 When to Use This Skill

Invoke this skill when working with entgo:

• Schema design: Defining entities, fields, relationships, indexes
• CRUD operations: Creating type-safe database operations
• Query optimization: Eager loading, pagination, aggregation
• Access control: Privacy policies, multi-tenant filtering
• Business logic: Hooks, validation, default values
• Database migrations: Schema versioning with Atlas
• Troubleshooting: Fixing entgo issues, understanding errors

📚 Knowledge Structure

Load specific guides as needed rather than reading everything at once:

Quick Start

Link: Official Ent Documentation Contains: Installation, creating schemas, code generation, database connection

Pattern Guides

Schema Definition

CRUD Operations

Advanced Queries

Business Logic

Database & Migrations

Integration & Extensions

Advanced Features

Best Practices

Troubleshooting

🚀 Quick Examples

Basic Schema

func (User) Fields() []ent.Field {
    return []ent.Field{
        field.String("name").NotEmpty(),
        field.String("email").Unique(),
        field.Int("age").Positive(),
    }
}

func (User) Edges() []ent.Edge {
    return []ent.Edge{
        edge.To("pets", Pet.Type),
    }
}

CRUD Operations

// Create
user, err := client.User.Create().
    SetName("Alice").
    SetEmail("alice@example.com").
    Save(ctx)

// Query with eager loading
users, err := client.User.Query().
    Where(user.AgeGT(18)).
    WithPets().
    All(ctx)

// Update
_, err := client.User.UpdateOneID(id).
    SetName("Bob").
    Save(ctx)

// Delete
err := client.User.DeleteOneID(id).Exec(ctx)

Transaction

err := WithTx(ctx, client, func(tx *ent.Tx) error {
    u, err := tx.User.Create().SetName("Alice").Save(ctx)
    if err != nil {
        return err
    }
    _, err = tx.Pet.Create().SetName("Fluffy").SetOwner(u).Save(ctx)
    return err
})

🔗 External Resources

• Official Docs: https://entgo.io/docs
• GitHub: https://github.com/ent/ent
• Atlas Migration: https://atlasgo.io
• Examples: https://github.com/ent/ent/tree/master/examples