Prisma Client Api

TopTinker Aug 13, 2026 New v1.0.0 811 installs Sec S+ Verified source
Claude Code Cursor
Free
Open verification
AI OverviewGenerated from SKILL.md
Core usage
This skill provides a Prisma Client API reference covering model queries, filters, operators, relations, transactions, and client methods. Use it when writing database queries, performing CRUD operations, filtering and sorting data, working with relations, using transactions, or configuring Prisma Client.
Key advantages
It organizes API guidance into clearly prioritized rule categories and provides quick reference tables for query methods, query options, filter operators, and client methods. It includes practical TypeScript examples and points to detailed reference files for deeper documentation.
Limitations
This is a reference and guidance skill rather than an interactive tutorial, so it assumes familiarity with Prisma projects and generated clients. The examples use a generated client path and specific adapter setup that may require adjustment for different projects or Prisma versions.
Target audience
This is for developers using Prisma Client in current Prisma projects who need API guidance for database queries, CRUD operations, filtering, relations, transactions, or client configuration. It is also useful for developers applying Prisma Client patterns such as extensions, raw queries, and transaction workflows.
Risks & notes
Raw queries and transaction patterns are marked as critical, so misuse can cause unsafe SQL execution or inconsistent database operations. Users should consult the referenced rule files and follow the documented safety guidance, and should verify that the generated client path and adapter setup match their project configuration.
DescriptionWritten by the seller

# Prisma Client API Reference

Complete API reference for Prisma Client. This skill provides guidance on model queries, filtering, relations, and client methods for current Prisma projects.

## When to Apply

Reference this skill when:
- Writing database queries with Prisma Client
- Performing CRUD operations (create, read, update, delete)
- Filtering and sorting data
- Working with relations
- Using transactions
- Configuring client options

## Rule Categories by Priority

Priority Category Impact Prefix
1 Client Construction HIGH `constructor`
2 Model Queries CRITICAL `model-queries`
3 Query Shape HIGH `query-options`
4 Filtering HIGH `filters`
5 Relations HIGH `relations`
6 Transactions CRITICAL `transactions`
7 Raw SQL CRITICAL `raw-queries`
8 Client Methods MEDIUM `client-methods`

## Quick Reference

- `constructor` - `PrismaClient` setup, adapter wiring, logging, and SQL commenter plugins
- `model-queries` - CRUD operations and bulk operations
- `query-options` - `select`, `include`, `omit`, sort, pagination
- `filters` - scalar and logical filter operators
- `relations` - relation reads and nested writes
- `transactions` - array and interactive transaction patterns
- `raw-queries` - `$queryRaw` and `$executeRaw` safety
- `client-methods` - lifecycle methods, extensions, and `satisfies` patterns for `prisma-client`

## Client Instantiation

```typescript
import { PrismaClient } from '../generated/client'
import { PrismaPg } from '@prisma/adapter-pg'

const adapter = new PrismaPg({
connectionString: process.env.DATABASE_URL
})

const prisma = new PrismaClient({ adapter })
```

## Model Query Methods

Method Description
`findUnique()` Find one record by unique field
`findUniqueOrThrow()` Find one or throw error
`findFirst()` Find first matching record
`findFirstOrThrow()` Find first or throw error
`findMany()` Find multiple records
`create()` Create a new record
`createMany()` Create multiple records
`createManyAndReturn()` Create multiple and return them
`update()` Update one record
`updateMany()` Update multiple records
`updateManyAndReturn()` Update multiple and return them
`upsert()` Update or create record
`delete()` Delete one record
`deleteMany()` Delete multiple records
`count()` Count matching records
`aggregate()` Aggregate values (sum, avg, etc.)
`groupBy()` Group and aggregate

## Query Options

Option Description
`where` Filter conditions
`select` Fields to include
`include` Relations to load
`omit` Fields to exclude
`orderBy` Sort order
`take` Limit results
`skip` Skip results (pagination)
`cursor` Cursor-based pagination
`distinct` Unique values only

## Client Methods

Method Description
`$connect()` Explicitly connect to database
`$disconnect()` Disconnect from database
`$transaction()` Execute transaction
`$queryRaw()` Execute raw SQL query
`$executeRaw()` Execute raw SQL command
`$on()` Subscribe to events
`$extends()` Add extensions

## Quick Examples

### Find records

```typescript
// Find by unique field
const user = await prisma.user.findUnique({
where: { email: 'alice@prisma.io' }
})

// Find with filter
const users = await prisma.user.findMany({
where: { role: 'ADMIN' },
orderBy: { createdAt: 'desc' },
take: 10
})
```

### Create records

```typescript
const user = await prisma.user.create({
data: {
email: 'alice@prisma.io',
name: 'Alice',
posts: {
create: { title: 'Hello World' }
}
},
include: { posts: true }
})
```

### Update records

```typescript
const user = await prisma.user.update({
where: { id: 1 },
data: { name: 'Alice Smith' }
})
```

### Delete records

```typescript
await prisma.user.delete({
where: { id: 1 }
})
```

### Transactions

```typescript
const [user, post] = await prisma.$transaction([
prisma.user.create({ data: { email: 'alice@prisma.io' } }),
prisma.post.create({ data: { title: 'Hello', authorId: 1 } })
])
```

## Rule Files

Detailed API documentation:

```
references/constructor.md - PrismaClient constructor options
references/model-queries.md - CRUD operations
references/query-options.md - select, include, omit, where, orderBy
references/filters.md - Filter conditions and operators
references/relations.md - Relation queries and nested operations
references/transactions.md - Transaction API
references/raw-queries.md - $queryRaw, $executeRaw
references/client-methods.md - $connect, $disconnect, $on, $extends
```

## Filter Operators

Operator Description
`equals` Exact match
`not` Not equal
`in` In array
`notIn` Not in array
`lt`, `lte` Less than
`gt`, `gte` Greater than
`contains` String contains
`startsWith` String starts with
`endsWith` String ends with
`mode` Case sensitivity

## Relation Filters

Operator Description
`some` At least one related record matches
`every` All related records match
`none` No related records match
`is` Related record matches (1-to-1)
`isNot` Related record doesn't match

## Resources

- [Prisma Client API Reference](https://www.prisma.io/docs/orm/reference/prisma-client-reference)
- [CRUD Operations](https://www.prisma.io/docs/orm/prisma-client/queries/crud)
- [Filtering and Sorting](https://www.prisma.io/docs/orm/prisma-client/queries/filtering-and-sorting)

## How to Use

Pick the category from the table above, then open the matching reference file for implementation details and examples.

Use caseInput → Output
Input
Writing database queries with Prisma Client; Performing CRUD operations (create, read, update, delete); Filtering and sorting data
Output
Verified guidance, commands and best practices for Prisma Client Api, ready to paste into your agent
How it worksImport to your platform and run
Item details
Use case
AI Skills
Capability
Coding
Agents
Claude Code, Cursor
Version
1.0.0
First seen
Aug 13, 2026
Installs
811
License
Non-exclusive
Last update
Aug 13, 2026
InstallCompatible with agent skill ecosystem
npx skills add prisma/skills --skill prisma-client-api
Source: prisma/skills
What you get
SKILL.md skill definitionCommand referenceInstallation instructionsPrisma Client Api reference
Verified sourceOriginal project page — inspect before install
Open the original source project
Check the upstream repository, license and changelog before install
Open source
Security ScanS+Score 100/100 · 2 findings · 2026-08-15 21:31:48🤖 AI 已复核
Static analysis100
Dynamic behavior100
Dependencies100
Network100
Privacy100
Threat intel100
Findings (2)
LowBulk env var collection(false positive)1 处
Enumerates all environment variables (may leak credentials); read only what is needed.
🤖 process.env is normal environment access and no exfiltration or dangerous action is shown.
L55 · process.env
LowCredential env var read(false positive)1 处
Reads credential env vars; confirm the function genuinely needs them.
🤖 Reading DATABASE_URL from process.env is standard configuration access, not inherently malicious.
L55 · process.env.DATABASE_URL
Security scan generated by TopTinker automated engine from SKILL.md static analysis, for pre-install reference only. Third-party skills carry their own runtime risk.
WeChat
Qizhuwang Source Code Trading Platform
2021-12-28开店时间
284商品数
认证
Guarantees
Escrow paymentOn
Platform holds funds until delivery is confirmed
Install verified
Free download - install & run before you pay
Source transparency
Original GitHub repo linked & verified
No refunds after download
Digital product - disputes arbitrated on evidence only
Enhanced protection
Trusted seller - priority arbitration within 48h, backed by platform bond
Upgrade to ProRecommended
Full-Stack Developer Skill Pack
Complete skill bundle · Pack
View Pack
Free

Report this listing

This content is locked. Buy it once and use it forever - instant delivery after purchase.

one-time
Unlock now
Escrow payment · 7-day refund support