Official agent skill

Docs Writer

by prisma in prisma/web

A skill your agent uses when writing, rewriting, or improving technical docs (quickstarts, how-tos, tutorials, concept pages, or API references).

OfficialNo licenceAuto-check: notesDatabases

Install Docs Writer

skills CLI
$ npx skills add prisma/web --skill docs-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install prisma/web docs-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/prisma/web.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/docs-writer .claude/skills/docs-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
docs-writer
GitHub stars
1.1k
Token cost
~5.2k tokens
SKILL.md length
3,183 words
Files
4 (incl. references)
Skills in repo
6
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when writing, rewriting, or improving technical docs (quickstarts, how-tos, tutorials, concept pages, or API references).

  • Works in 6 steps: Title: name the task as a verb phrase.… → Intro (1-2 sentences): state what the… → Prerequisites: a bulleted list with… → …
  • Improving technical docs (quickstarts
  • SKILL.md covers Foundation, Before you write, Page shape and Other page types, plus 8 more sections
  • Calls curl and npx

What it does

Docs Writer is an agent skill from prisma/web, published by the product's own GitHub organization. Use when writing, rewriting, or improving technical docs (quickstarts, how-tos, tutorials, concept pages, or API references).

Its SKILL.md is about 5.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `README.md`, `references/how-to-use.md` and `references/prisma-8.md`).

It sits in Databases, covering ORMs and data access. It works with Prisma. The repository describes itself as: 📚 Prisma Web Monorepo.

When your agent uses it

  • Improving technical docs (quickstarts
  • API references)

Example prompts

  • “/docs-writer”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Title: name the task as a verb phrase. "Deploy a Prisma Compute app", not "Deployment".
  2. Intro (1-2 sentences): state what the reader will have done by the end, and the one reason it matters.
  3. Prerequisites: a bulleted list with exact versions and links. The reader should clear this list in under a minute.
  4. Numbered steps: see "Writing a step".
  5. Verify: a command the reader can copy and run, with the exact expected output. "You should see your app respond" is not a verification…
  6. Next steps: one to three links to the obvious follow-on tasks.

What it can do on your machine

Read from SKILL.md and the folder at commit 00dd22d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • en.wikipedia.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Docs Writer loads about 5.2k tokens when it runs, and up to ~7.1k if it reads all its reference files. Until then it costs about 34 tokens; SKILL.md has 3,183 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~5.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:104
    ` directory with your schema file and a `.env` file for your database connection string.
  • NoteMentions a .env fileSKILL.md:110
    u now have `prisma/schema.prisma` and a `.env` file. Open `.env` and confirm `DATABASE_URL` is present.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 3,183 words (~5,192 tokens).

“Write documentation a developer can follow from start to finish without getting stuck or guessing. Every page answers three questions, in this order: what am I doing, why does it matter, and what do I do next.”

— opening of SKILL.md by prisma
name
docs-writer
metadata.author
Prisma
metadata.version
2026.9.16

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references) in .claude/skills/docs-writer of prisma/web.

  • SKILL.md
  • README.md
  • references/how-to-use.md
  • references/prisma-8.md

Open the folder on GitHubat commit 00dd22d

Compare with similar skills

Docs Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Docs Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Writer this skillprisma/web1.1k—~5.2kAutomated safety check: NotesNone
Prisma Client APIcurvenote/curvenote1692 repos~1.6kAutomated safety check: PassMIT
Prismablencorp/claude-code-kit106—~2.7kAutomated safety check: PassMIT
Prisma Expertdavila7/claude-code-templates32k6 repos~2.6kAutomated safety check: PassMIT
Survey MethodologyMuuuun/luxas1.2k—~8.1kAutomated safety check: PassMIT
Check ReportingAperivue/medsci-skills3291 repos~7.9kAutomated safety check: PassMIT

Similar skills

  • Prisma Client API

    curvenote/curvenote

    Prisma Client API reference covering model queries, filters, operators, and client methods.

    169 GitHub starsUsed in 2 repos~1.6k tokens
    DatabasesAuto-check passed
  • Prisma

    blencorp/claude-code-kit

    Prisma ORM patterns including Prisma Client usage, queries, mutations, relations, transactions, and schema management.

    106 GitHub stars~2.7k tokensUpdated 10 mo ago
    DatabasesAuto-check passed
  • Prisma Expert

    davila7/claude-code-templates

    Prisma ORM expert for schema design, migrations, query optimization, relations modeling, and database operations.

    32k GitHub starsUsed in 6 repos~2.6k tokens
    DatabasesAuto-check passed
  • Survey Methodology

    Muuuun/luxas

    Plan-time methodology contract for survey/review/report projects.

    1.2k GitHub stars~8.1k tokensUpdated 1 mo ago
    DatabasesAuto-check passed
  • Check Reporting

    Aperivue/medsci-skills

    A skill your agent uses when auditing a manuscript item by item against a reporting guideline or risk-of-bias tool.

    329 GitHub starsUsed in 1 repo~7.9k tokens
    DatabasesAuto-check passed
  • Deploying Palo Alto Prisma Access Zero Trust

    mukul975/Anthropic-Cybersecurity-Skills

    Deploys Palo Alto Networks Prisma Access for SASE-based zero trust network access, configuring GlobalProtect agents, ZTNA Connectors, security policy enforcement, and Strata Cloud Manager…

    34k GitHub stars~2.8k tokensUpdated 1 mo ago
    DatabasesAuto-check passed

More from prisma/web

  • Official

    A skill your agent uses when the operator wants a hero or meta image for a Prisma blog post; asks to create or generate a blog hero, cover, social card, Open Graph, or YouTube image; mentions cover…

    1.1k GitHub stars~6.9k tokensUpdated today
    Auto-check passed
  • Official

    A skill your agent uses when a docs page or section has been written or rewritten and is about to be handed over, when the operator says "reader review", "does this read like a human wrote it", "too…

    1.1k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Content SEO Geo

    prisma/web

    Official

    Optimize a prisma.io page for search engines and AI answer engines.

    1.1k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Official

    A skill your agent uses when the operator wants to write a blog post, draft a blog article, start a new post for the Prisma blog, or publish to prisma.io/blog.

    1.1k GitHub stars~4.9k tokensUpdated today
    Auto-check passed
  • Official

    A skill your agent uses when adding a new docs section or product area, editing llms.ts / the llms.txt or llms/[...slug] / llms-full.txt routes / get-llm-text / skill.md / .well-known endpoints, or…

    1.1k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Docs Writer

What does Docs Writer do?

A skill your agent uses when writing, rewriting, or improving technical docs (quickstarts, how-tos, tutorials, concept pages, or API references). Docs Writer is an agent skill from prisma/web, published by the product's own GitHub organization. Use when writing, rewriting, or improving technical docs (quickstarts, how-tos, tutorials, concept pages, or API references).

When should I use Docs Writer?

Docs Writer fits situations like: improving technical docs (quickstarts; API references).

How do I install Docs Writer in Claude Code?

Run `npx skills add prisma/web --skill docs-writer -a claude-code`. Or copy the skill folder (.claude/skills/docs-writer in prisma/web) into .claude/skills/docs-writer in your project. Claude Code loads it when a task matches its description.

How do I install Docs Writer in Codex?

Run `npx skills add prisma/web --skill docs-writer -a codex`. Or copy the skill folder (.claude/skills/docs-writer in prisma/web) into .agents/skills/docs-writer in your project. Codex loads it when a task matches its description.

Can I use Docs Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add prisma/web --skill docs-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-writer, .gemini/skills/docs-writer, .github/skills/docs-writer and .opencode/skills/docs-writer in your project.

What does Docs Writer need to run?

Going by SKILL.md and its folder, Docs Writer needs the command-line tools its instructions call (curl and npx). Our summary lists: Node.js.

Does Docs Writer access the network?

SKILL.md names 1 domain. As links in the text: en.wikipedia.org. This is read from the text; nothing was executed.

Is Docs Writer safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Docs Writer use?

No licence was found for Docs Writer or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Docs Writer use?

About 5.2k tokens (SKILL.md is roughly 21k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.9k tokens, read only when the agent opens those files.

What are the alternatives to Docs Writer?

Skills that share tags, products or a category with Docs Writer: Prisma Client API (curvenote/curvenote, 169 stars), Prisma (blencorp/claude-code-kit, 106 stars), Prisma Expert (davila7/claude-code-templates, 32k stars) and Survey Methodology (Muuuun/luxas, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Writer?

prisma (a GitHub organization, an official publisher) maintains it in prisma/web, which has 1,103 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 7, 2026.

Source: prisma/web on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.