Ira Bodnar··Updated ·11 min read

Claude Skills for Directus: 9 SKILL.md Files for Items and Collections

Quick answer: Save each Directus chore as a Claude skill that names the tool to call and the table to hand back. Ryze AI is the best Claude connector for running these skills on a Directus instance in 2026, with one caveat: it connects one Directus instance per workspace, using a static token whose user role decides which collections the skills can see.

Below: 9 SKILL.md files, which of the 3 Directus tools each one calls, install steps, the limits that apply and a short troubleshooting list.

Ryze AI · SEO Starter

Directus skills on a live instance

  • 3-day free trial, $129 a month

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The 9 Claude skills for Directus at a glance

Five skills only read, three write and one removes. Each names the Ryze AI tool it calls.

  1. 01Data model reviewList collections and their fields

    Tool used: directus__read

    Cadence: Monthly

  2. 02Status backlogFind items still in draft

    Tool used: directus__read

    Cadence: Weekly

  3. 03Field gapsFind items with empty fields you name

    Tool used: directus__read

    Cadence: Per release

  4. 04File metadata checkList files with no title or description

    Tool used: directus__read

    Cadence: Quarterly

  5. 05Flow inventoryList flows and what they are set to do

    Tool used: directus__read

    Cadence: Quarterly

  6. 06Draft an itemCreate one item from your text

    Tool used: directus__read, directus__write

    Cadence: Per article

  7. 07Refresh item fieldsChange chosen fields with a before and after

    Tool used: directus__read, directus__write

    Cadence: Per refresh

  8. 08Bulk status changeUpdate the status of the items you list

    Tool used: directus__read, directus__write

    Cadence: Per batch

  9. 09Delete itemsDelete the items that match a rule you confirm

    Tool used: directus__read, directus__delete

    Cadence: Quarterly

The tool names and descriptions come from the Ryze AI integration source and the Ryze AI help center. Directus was not connected in any Ryze AI workspace available to us, so no skill here was run against a live instance and no numbers from a real instance appear. Run each skill on a test collection first.

What are Claude skills for Directus?

A Claude skill for Directus is a SKILL.md file that tells Claude how to run one content task and what to return. Anthropic's Agent Skills docs say the file opens with a name and a description. Claude loads those two fields at startup and reads the rest of the file only when a request matches the description.

The name takes up to 64 characters, lowercase letters, numbers and hyphens, and cannot contain the reserved words anthropic or claude. The description is capped at 1,024 characters and must say what the skill does and when to use it. Every skill here starts with directus for that reason.

  1. What it is

    Chat prompt
    One question typed into chat
    Skill
    A saved file with fixed steps and a fixed output
    Directus connection
    Tools Claude calls to reach the instance
  2. Setup

    Chat prompt
    None
    Skill
    Save once for each Claude app
    Directus connection
    An Instance URL and a static token entered in Ryze AI
  3. Repeatable

    Chat prompt
    Only if you retype it
    Skill
    Yes, the same steps every run
    Directus connection
    Depends on the prompt or skill

A skill holds instructions and no credentials, so one file works on any instance you connect. For the tool list, setup per client and the comparison with the Directus MCP server, see the Directus MCP page.

How to install the Directus skills in Claude

Claude Code

Put each block in ~/.claude/skills/<skill-name>/SKILL.md for yourself, or in .claude/skills/<skill-name>/SKILL.md inside a project to share it. Type /directus-draft-item to call a skill by name, or let Claude pick it from the description (Claude Code skills docs).

claude.ai

Zip each skill folder and upload it as a custom skill. Anthropic lists custom skills on Pro, Max, Ultra, Team and Enterprise plans with code execution enabled.

Connect the instance

Connect Directus inside Ryze AI, then add the Ryze AI connector to Claude. The steps are in the next sections, on the Directus MCP page and in the Ryze AI help center.

Anthropic states that custom skills do not sync between surfaces: a skill uploaded to claude.ai is absent from the API, and Claude Code skills live on disk apart from both. Anthropic also advises using skills only from sources you trust, so read each file before you save it, the ones on this page included.

The four skills that write or delete carry disable-model-invocation: true in their frontmatter. Per the Claude Code docs, that stops Claude from starting a skill by itself and leaves it to you to type the slash command. It applies to Claude Code, and it does not replace per-tool approvals in the connector.

Read skills: review the instance before you touch it

These five call only directus__read, which runs a read-only Directus REST request. Items, collections, fields, files, users, flows and server info are within its reach, and none of these skills changes anything. What comes back is limited to what the token's user role can see.

01. Data model review

Lists the collections on the instance with their fields, so you know the model before you ask for edits.

SKILL.md
--- name: directus-model-review description: Lists the collections on the connected Directus instance and their fields. Use when asked what the data model looks like or before any item change. --- # Directus data model review Use directus__read only. Do not call directus__write or directus__delete. Steps: 1. List every collection I can read, leaving out the system collections. 2. For each one, list its fields with the field type and whether it is required. 3. Note fields that look unused or duplicated across collections, such as two different title fields. Output: one table per collection. End with the collection that looks like the blog post collection and why.

Use it when: you inherit an instance or plan a bulk edit.

02. Status backlog

Finds items in one collection that were never published. Many Directus collections carry a status field with values such as draft and published, though the field and its values are your own choice, so the skill asks which one to use.

SKILL.md
--- name: directus-status-backlog description: Finds Directus items in one collection that are still drafts. Use when content is missing from the live site or when cleaning up before a launch. --- # Directus status backlog Use directus__read only. Steps: 1. Ask me for the collection and the name of its status field if I did not give them. 2. List the items whose status is not the published value I name. 3. Sort by last update, oldest first. Output: a table with item title, slug if the collection has one, status, last updated date and a one-line guess at whether it was abandoned. Change nothing.

Use it when: a post exists in the Data Studio but not on the site.

03. Field gaps

Checks the fields you name for empty values across one collection. Directus returns 100 items when a request sets no limit, so the skill asks for paging.

SKILL.md
--- name: directus-field-gaps description: Finds Directus items with empty values in fields I name, such as meta title or summary. Use before a release or an SEO pass. --- # Directus field gaps Use directus__read only. Steps: 1. Ask me for the collection and the fields to check. 2. Read all items in pages, since a request with no limit returns 100 items by default. Say how many pages you read. 3. Keep items where any named field is empty. Output: a table of item title, the empty field names and the count of affected items per field. Do not fill anything in.

Use it when: a content team wants every post to carry a summary and a meta description.

04. File metadata check

Lists files in the Directus file library with an empty title or description. Alt text for images often starts from this metadata, so gaps matter for accessibility and image search.

SKILL.md
--- name: directus-file-check description: Lists Directus files with an empty title or description. Use before an accessibility pass or an image SEO review. --- # Directus file metadata check Use directus__read only. Steps: 1. List the files I can read, in pages. 2. Keep files where the title or the description is empty. 3. Group by file type. Output: a table with file title, file name and which field is empty. Skip anything that looks like a test upload and say how many you skipped.

Use it when: a page audit flags images with no alt text.

05. Flow inventory

Lists the flows on the instance, which are Directus automations, so you can see what runs when items change.

SKILL.md
--- name: directus-flow-inventory description: Lists Directus flows with their status and trigger. Use before changing a collection that automations may depend on. --- # Directus flow inventory Use directus__read only. Steps: 1. List the flows I can read. 2. For each, report its name, whether it is active and its trigger. 3. Flag flows that look like duplicates by name. Output: one table. Say plainly if the token's role cannot read flows. Change nothing.

Use it when: you are about to run a bulk update and want to know what else reacts to it.

Write skills: create, refresh and bulk update items

These three call directus__write, which creates or updates items through the Directus REST API (POST or PATCH), including bulk updates of many items. In Claude, open Customize > Connectors > Ryze AI > Tool permissions and set write and delete tools to Needs approval, the setting the Ryze AI help center recommends. Each change then waits for your click.

06. Draft an item

Creates one item from text you paste. The skill sets the status field to its draft value when the collection has one, so nothing goes live by accident.

SKILL.md
--- name: directus-draft-item description: Creates one Directus item from text I provide, as a draft. Use when asked to add a post or other item to a collection. disable-model-invocation: true --- # Directus draft item Uses directus__read and directus__write. Steps: 1. Read the collection I name and list its fields, marking the required ones. 2. Map my text to the fields. Ask me about any required field I left empty. 3. If the collection has a status field, set it to the draft value. If it has none, tell me before going on. 4. Show the planned field values in a table and wait for my yes. 5. Create the item. Output: the item title and the fields written. State the status the item was saved with.

Use it when: you have a finished article and want it in the collection without pasting it into the Data Studio. For scheduled publishing, Ryze AI's Content Plan publishes articles into the collection you choose at setup.

07. Refresh item fields

Changes chosen fields on an existing item. The skill reads the whole item first and shows a before and after, so fields you did not mention stay as they are.

SKILL.md
--- name: directus-refresh-item description: Updates chosen fields on one existing Directus item and shows old and new values. Use when asked to fix, refresh or rewrite an item. disable-model-invocation: true --- # Directus refresh item Uses directus__read and directus__write. Steps: 1. Find the item by title or slug in the collection I name. If two match, ask which. 2. Read the full item, including translations if the collection has them. 3. Show the current and the new value for each field I want changed, and wait for my yes. 4. Send an update that contains only the fields I approved. Output: a before and after table. Say what status the item has.

Use it when: a post needs a corrected fact or a new intro.

08. Bulk status change

Updates the status of the items you list in one go. The write tool supports bulk updates, which is why the skill insists on a numbered list and a count before it runs.

SKILL.md
--- name: directus-bulk-status description: Changes the status field of the Directus items I name, after a final check. Use when drafts are reviewed and ready to go live, or to pull items back to draft. disable-model-invocation: true --- # Directus bulk status change Uses directus__read and directus__write. Steps: 1. Ask me for the collection, the status field, the new value and the exact items, by title or slug. 2. Read each one. Flag any required field that is empty. 3. Show a numbered list with the flags and the total count, then wait for me to confirm. 4. Update only the confirmed items and report each result. Output: updated items, skipped items and the reason for each skip. Never touch an item that is not on the list.

Use it when: an editor signed off on a batch. The token user needs update access to the collection and its status field; if the role lacks it, Directus refuses the change.

Cleanup skill: delete items with a confirmation step

directus__delete deletes one or many items through the Directus REST API. Deleting is final, so the tool sits apart from write, and you can allow edits while keeping removals on approval.

09. Delete items

SKILL.md
--- name: directus-delete-items description: Deletes Directus items that match my rule, after I confirm the list. Use for test items and retired content. disable-model-invocation: true --- # Directus delete items Uses directus__read and directus__delete. Steps: 1. Ask me for the collection and the rule, such as titles that start with Test. 2. List the matching items. Delete nothing yet. 3. Show title, slug and status for each item with the total count. Wait for my confirmation. 4. Delete only the confirmed items and report each result. Output: items deleted and items skipped. Remind me to check the Directus revision history or a backup if I need one back.

Use it when: you are clearing test items before a launch. Keep Needs approval on the delete tool in Claude, in addition to the skill's own confirmation step.

How to run the skills on a live Directus instance

A skill describes the work and Claude needs a connection to do it. The Ryze AI connector gives Claude 3 Directus tools:

  1. directus__read

    What it does
    Runs a read-only Directus REST request, such as items in a collection, collections, fields, files, users, flows and server info
    Used by
    All 9 skills
  2. directus__write

    What it does
    Creates or updates items through the Directus REST API (POST or PATCH), including bulk updates of many items
    Used by
    Skills 06, 07, 08
  3. directus__delete

    What it does
    Deletes one or many items through the Directus REST API
    Used by
    Skill 09

To connect, open a Directus user with the right role for your blog collection, click Generate next to Token, copy it and save the user. In Ryze AI, open Integrations, click Connect on the Directus card and enter the Instance URL (the Data Studio origin, https://, no path), the token and your public Blog URL. Then pick the collection articles publish to and, for translated collections, a language code (Ryze AI Directus guide).

The connector needs an active Ryze AI plan or trial, and connecting it costs nothing. SEO Starter is $129 a month with a 3-day free trial, and annual billing is 30% off the first year (pricing). After you connect Directus in Ryze AI, remove the Ryze AI connector in Claude, add it again and start a new chat, because Claude keeps the tool list from the moment the connector was added (Ryze AI help center).

Two scope limits matter for skills. A workspace holds one Directus connection, so a skill cannot compare two instances. The token also follows its user's role: Directus says static tokens inherit the permissions of the user they belong to, so a collection the role cannot see is invisible to every skill.

Directus ships its own MCP server for v11.12 and later. You turn it on under Settings > AI and generate a token for a dedicated MCP user, and its tools cover schema, items, collections, files and assets (Directus MCP guide). Its tool names differ from the Ryze AI names, so a skill written for directus__read would need editing before it works there. The Directus MCP page carries the full comparison.

Limits that shape these skills

  1. Directus connections per Ryze AI workspace

    Value
    1
    Effect on a skill
    Skills run against one instance at a time
  2. Token role

    Value
    Same permissions as the token's user
    Effect on a skill
    Skills 06 to 09 fail where the role cannot create, update or delete
  3. Default page size (QUERY_LIMIT_DEFAULT)

    Value
    100 items
    Effect on a skill
    Skills 03 and 04 ask Claude to read in pages
  4. Maximum page size (QUERY_LIMIT_MAX)

    Value
    -1, no cap by default
    Effect on a skill
    An admin may set a cap on your instance
  5. Rate limiter (RATE_LIMITER_ENABLED)

    Value
    Off by default; 50 points per 1 second when on
    Effect on a skill
    Large audits may slow down on instances that turned it on
  6. Custom skill upload in claude.ai

    Value
    Pro, Max, Ultra, Team and Enterprise with code execution
    Effect on a skill
    Free users can still use the connector but not uploaded skills
  7. Free plan custom connectors

    Value
    1 in total
    Effect on a skill
    Ryze AI would use that single slot
  8. Skill name

    Value
    64 characters, lowercase letters, numbers, hyphens
    Effect on a skill
    Names cannot include claude or anthropic

The Directus limits come from its security limits reference, opened November 19, 2026. Each is an environment setting, so your instance, or a managed one, may use other values.

Troubleshooting: when a Directus skill fails

Claude has no Directus tools

Claude keeps the tool list from when the connector was added. Connect Directus in Ryze AI first, then remove and re-add the connector and start a new chat.

The token is rejected

A token generated without saving the user afterwards is rejected. Open the user, generate the token again, save the user and reconnect.

A collection is missing from results

Collections the token's role cannot see are not available. Give the role read access to the collection in Directus.

Instance URL is refused

Use the Data Studio origin with https:// and nothing after the domain.

Lists stop at 100 items

Directus applies a default limit of 100 when a request names none. Ask Claude to read in pages.

Connect link refused

A connection link is refused while a Directus connection already exists in the workspace. Click View, disconnect with the trash icon and connect again.

A skill does not start in Claude Code

Check the path is ~/.claude/skills/<name>/SKILL.md. Skills marked disable-model-invocation: true start only when you type the slash command.

Sources

The verdict

Turn each recurring Directus chore into a skill that names its tool and ends with a confirmation step. Start with the data model review and the status backlog, then add the write skills once approvals are set.

Ryze AI runs these skills in Claude through 3 Directus tools on one instance. The token user's role decides what each skill can see and change.

Frequently asked questions

What are Claude skills for Directus?
SKILL.md files that tell Claude which Directus task to run, which Ryze AI tool to call and how to present the result. Claude loads one when a request matches its description, so an audit or a bulk update runs the same way each time.
Do I need a Directus connection to use these skills?
To run them on your instance, yes. Without one, Claude can follow the steps on exported content or pasted text, but it cannot read or change Directus.
Which Claude plan do I need?
Anthropic lists custom skill uploads on claude.ai for Pro, Max, Ultra, Team and Enterprise with code execution enabled. In Claude Code, skills are folders on your computer. For the connector, Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, with Free limited to one.
How many Directus tools does Ryze AI give Claude?
3: directus__read, directus__write and directus__delete. Read runs read-only requests for items, collections, fields, files, users, flows and server info. Write creates or updates items, including bulk updates. Delete removes one or many items.
Show 7 more questions
Will Claude change items without asking?
That depends on your settings. In Claude, open Customize > Connectors > Ryze AI > Tool permissions and set write and delete tools to Needs approval. The write skills on this page also ask for a yes before each change.
What do I need from Directus to connect?
An Instance URL (the Data Studio origin with https:// and no path), a static access token generated on a user whose role can read and write the blog collection, and your public Blog URL. You then pick the collection articles publish to.
Can the skills work on more than one instance?
One Directus connection is allowed per workspace. To switch, click View in Ryze AI, disconnect with the trash icon and connect again.
Why can the skills not see one of my collections?
The static token has the permissions of its user, so a collection the role cannot read stays out of reach. Change the role in Directus, then run the skill again.
How do these differ from the Directus MCP server?
Directus ships its own MCP server for v11.12 and later, turned on under Settings > AI, with its own tool names. Ryze AI exposes 3 Directus tools through one connector URL, https://connector.get-ryze.ai/mcp, with the token stored in Ryze AI. The Directus MCP page compares them.
Do the skills work outside Claude?
SKILL.md is the format Claude reads. The Directus tools on the Ryze AI connector work in other MCP clients, where you can paste a skill's steps into a prompt.
How much does it cost?
Connecting the Ryze AI connector is free, and the Directus tools need an active plan or trial. SEO Starter is $129 a month with a 3-day free trial, and annual billing is 30% off the first year.

Related guides

Ryze AI: Directus skills on a live instance

3-day free trial, $129 a month

Start free trial