AI
Skills
How this project uses shared AI context and how to add new context files.
Existing AI context (.agents/skills)
This project keeps AI-specific guidance in .agents/skills.
AGENTS.mdis the single source of truth.- It contains short global instructions and a context map.
- Topic files in
.agents/skills/*/SKILL.mdhold focused context (for example auth, db, seo, i18n).
Available skills
| Prompt | Skill | Short description |
|---|---|---|
/admin-tasks Add admin section, update admin tables | admin-tasks | Creating CRUD features and admin UI sections |
/ai-sdk Integrate AI generation, call OpenAI models | ai-sdk | Use Vercel AI SDK, generateText, streamText, tool calling |
/analytics Add analytics events, configure tracking | analytics | Google Analytics, Plausible, PostHog, user action tracking |
/api-requests Fetch data from API, debug endpoint | api-requests | Fetch data, debug tRPC/oRPC endpoints |
/authentication Implement login, fix auth bug | authentication | Login flows, OAuth providers, session management |
/components Create UI component, update Tailwind styles | components | Build reusable React components with Tailwind |
/cron-jobs Add background task, configure worker | cron-jobs | Schedule and manage background cron jobs |
/dashboards Create analytics dashboard, update charts | dashboards | Build data dashboards and chart visualizations |
/data-tables Create data table, add pagination | data-tables | Sortable, filterable data tables with pagination |
/dates Format dates, handle timezones | dates | Date formatting, timezones, date-fns utilities |
/database-operations Create Prisma migration, update schema | database-operations | Prisma migrations, schema changes, DB queries |
/emails Send email notification, create template | emails | Transactional email templates and delivery |
/environment-variables Add or update environment variables | environment-variables | Manage .env files and runtime config |
/imports-exports Export data to CSV, import bulk data | imports-exports | CSV/bulk data import and export flows |
/features Scaffold new feature, add domain logic | features | End-to-end feature scaffolding and domain setup |
/filters Add search filters, implement query states | filters | URL-based filters and query state management |
/formatting Update code style rules, explain formatting | formatting | Biome config, linting, and code style rules |
/forms Create form, add validation | forms | React Hook Form, Zod validation, form patterns |
/infra Managing infrastructure, terraform | infra | Terraform provisioning and server infrastructure |
/internationalization Add translations, handle localization | internationalization | i18n setup, translation keys, locale routing |
/notifications Send in-app notifications, handle alerts | notifications | In-app notification delivery and alert handling |
/payments Add Stripe checkout, fix billing logic | payments | Stripe integration, subscriptions, billing flows |
/permissions Update user roles, check permissions | permissions | Role-based access control and permission checks |
/project-structure Understand app architecture, find files | project-structure | Navigate and understand the codebase layout |
/database-seeds Seed database, create test data | database-seeds | Prisma seed scripts and test data generation |
/seo Update meta tags, add opengraph images | seo | SEO metadata, sitemap, OpenGraph configuration |
/storage Upload files, handle S3/R2 storage | storage | File uploads with S3-compatible object storage |
/tasks Manage tasks, create plan, execute | tasks | AI task planning and step-by-step execution |
/theming Update Tailwind styles, customize fonts | theming | Global CSS variables, Tailwind theme, shadcn/ui |
More skills available
You can install additional pre-built skills from skills.sh.
How to add new context
Create a file
Create a focused context file in .agents/skills/*/SKILL.md.
Keep it focused
Keep it short and specific to one domain (for example: billing, notifications, search).
Link in source of truth
Add a link to the new file in AGENTS.md under the context map.
Avoid duplication
Do not duplicate the same rules in tool-specific root files.
Recommended format for a context file
We follow the AgentSkills Standard for structuring our AI context files. Use a simple structure:
- Purpose (what this context is for)
- Key conventions
- Important files and folders
- Common pitfalls
This keeps token usage low and helps AI tools load only relevant context.