Skip to main content

AI Skill in Voiden

Your AI assistant is great at writing code but it doesn't know Voiden's .void format out of the box. This is why we have added an AI Skill that fixes that. Enable it once from your settings, and your AI assistant will know everything it needs to write, edit, and generate valid .void files together with you.

How It Works​

When you enable AI Skill, Voiden generates a skill.md file inside your project's .voiden directory, right where your assistant can find it:

AssistantSkill file location
Claude.claude/skills/voiden/skill.md
Codex.codex/skills/voiden/skill.md

The file covers the full .void format: block types, structure rules, variable syntax, and the features from your enabled plugins. Your assistant picks it up automatically as context, so it can read your existing files and generate new ones correctly when required.

Enabling AI Skill​

Head to Settings → AI Skill and toggle on the assistant(s) you use:

ai-skill
  • Claude — Generates a skill file for Claude.
  • Codex — Generates a skill file for Codex-based assistants.

You can enable both at the same time. In this case, each will get their own file.

tip

Whenever you enable or disable a plugin, come back here and regenerate the skill file so your assistant stays in sync with your current setup.

What the Skill File Includes​

The skill file is built from two layers, so your assistant only learns what's actually relevant to your project:

Core — Always Included​

These fundamentals are always present, no matter what plugins you have enabled:

  • .void file format — frontmatter fields, block structure, UUID rules, variable syntax
  • Environment variables — {{VARIABLE_NAME}} syntax and .env file usage
  • File naming conventions — kebab-case naming, folder structure by resource

Plugins — Included When Enabled​

Each plugin adds its own block types and syntax. Only what's enabled in your project gets included:

PluginBlocks added to skill file
Voiden REST APIrequest, method, url, headers-table, query-table, path-table, json_body, xml_body, yml_body, text_body, multipart-table, url-table
Voiden GraphQLgqlquery, gqlvariables
Simple Assertionsassertions-table with all operators and field path syntax
Advanced Authenticationauth block with all auth types: bearer, basic, apiKey, oauth2, oauth1, digest, awsSignature, ntlm, hawk, netrc
Voiden Scriptingpre_script, post_script, full vd API reference
Voiden Faker{{$faker.*()}} syntax with all available categories and methods

Example Usage​

Once the skill file is in place, your assistant knows exactly how Voiden works. Try asking things like:

  • "Create a POST request to /api/users with a JSON body and Bearer auth"
  • "Add assertions to check the status is 200 and body.id exists"
  • "Write a pre-script that reads USER_ID from variables and sets it as a header"
  • "Generate a request body using faker for name, email, and UUID"

It will produce valid .void blocks — correct format, correct block types, correct syntax — ready to drop straight into your file.

note

The skill.md file is auto-generated by Voiden. Don't edit it manually — any changes will be overwritten the next time it's regenerated.

Summary​

AI Skill generates a skill.md file that teaches your AI assistant (Claude or Codex) the .void file format — covering core blocks, variable syntax, and whichever plugin features you have enabled. Enable it from Settings → AI Skill, and your assistant can generate valid .void blocks on request. Regenerate the file after changing plugins to keep it up to date.