skills: Instructions file for Codex

AGENTS.md

This file provides guidance to AI coding agents (Claude Code, OpenCode, Cursor, Copilot, etc.) when working with code in this repository.

Repository Overview

A collection of skills for AI coding agents working with Prisma ORM, Prisma Postgres and Prisma Compute. Skills are packaged instructions and rules that extend agent capabilities for database development, app deployment, query optimization, and best practices.

Creating a New Skill

Directory Structure

skills/
  {skill-name}/           # kebab-case directory name
    SKILL.md              # Required: skill definition with frontmatter
    references/           # Optional: individual reference files
      {category}-{rule}.md # Individual references

Naming Conventions

• Skill directory: kebab-case, prefixed with prisma- (e.g., prisma-schema-best-practices)
• SKILL.md: Always uppercase, always this exact filename
• Reference files: {category}-{rule-name}.md in kebab-case (e.g., relations-explicit-names.md)
• Categories: Use consistent prefixes matching the skill's category table

SKILL.md Format

---
name: prisma-{skill-name}
description: {One sentence describing when to use this skill. Include trigger phrases.}
license: MIT
metadata:
  author: prisma
  version: "1.0.0"
---

# Prisma {Skill Title}

{Brief description of what the skill covers.}

## When to Apply

{Bullet list of scenarios when this skill should be used}

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | {Category} | CRITICAL | `{prefix}-` |
| 2 | {Category} | HIGH | `{prefix}-` |
...

## Quick Reference

### 1. {Category} (CRITICAL)

- `{prefix}-{rule}` - Brief description
- `{prefix}-{rule}` - Brief description

### 2. {Category} (HIGH)
...

## How to Use (Optional)

If the skill includes references, read individual reference files for detailed explanations and code examples:

references/{prefix}-{rule}.md

Each reference file contains:
- Brief explanation of why it matters
- Incorrect code example with explanation
- Correct code example with explanation
- Additional context and references