Official agent skill

Vibe Skill Creator

by mistralai in mistralai/mistral-vibe

Guides your agent in creating, updating or deleting Mistral Vibe skills: what to ask you, where skills live, how they are discovered and the SKILL.md frontmatter rules.

OfficialApache-2.0Auto-check passedAgent Workflows

Install Vibe Skill Creator

skills CLI
$ npx skills add mistralai/mistral-vibe --skill skill-creator -a claude-code

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

GitHub CLI
$ gh skill install mistralai/mistral-vibe skill-creator --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/mistralai/mistral-vibe.git skills-src && mkdir -p .claude/skills && cp -r skills-src/vibe/plugins/builtins/vibe/skills/skill-creator .claude/skills/skill-creator && 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
skill-creator
GitHub stars
5.1k
Token cost
~1.2k tokens
SKILL.md length
642 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
Apache-2.0

At a glance

Guides your agent in creating, updating or deleting Mistral Vibe skills: what to ask you, where skills live, how they are discovered and the SKILL.md frontmatter rules.

  • Works in 3 steps: Name — a slug (lowercase, hyphens), e.g.… → Purpose / description — when should this… → Instructions — what should the skill…
  • Creating a new Vibe skill for a project or for all your projects
  • SKILL.md covers Gathering requirements, What a skill is, Where skills live (discovery… and SKILL.md format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This skill is the built-in guide for authoring Vibe skills. When creating one, the agent asks one question at a time for the name (a lowercase slug), the purpose that serves as the routing description, and the instructions, then confirms whether the skill is project or global scope before writing. A skill is a directory with a SKILL.md file holding YAML frontmatter and Markdown instructions. The model loads it on demand with the skill tool, and a user-invocable one can also be typed as /skill-name.

It lists the discovery order, where the first match wins: skill_paths in config.toml, then .vibe/skills and .agents/skills in the project, then the same folders under the home directory. Built-in skill names are reserved, so a user skill with a colliding name is silently skipped, and built-in and registry skills should not be hand-edited. The frontmatter section requires a name of lowercase letters, numbers and hyphens, 1 to 64 characters, ideally matching the directory name.

When your agent uses it

  • Creating a new Vibe skill for a project or for all your projects
  • Updating or deleting an existing Vibe skill
  • Working out why a skill is not being loaded by Vibe

Example prompts

  • “Create a Vibe skill called format-changelog for this project.”
  • “Why is my run-migrations skill not showing up? Check the discovery order and the name.”
  • “Move my format-changelog skill from the project folder to my global skills folder.”

Requirements

  • Mistral Vibe with a skills directory you can write to

Workflow steps

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

  1. Name — a slug (lowercase, hyphens), e.g. run-migrations or
  2. Purpose / description — when should this skill load? This is the routing text
  3. Instructions — what should the skill actually tell the model to do? Steps,

What it can do on your machine

Read from SKILL.md and the folder at commit 7cb9189. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

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

  • Network

    No URLs in SKILL.md.

    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

Vibe Skill Creator loads about 1.2k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 642 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from mistralai/mistral-vibe at commit 7cb9189, republished under its Apache-2.0 licence (© mistralai). 642 words, ~1,199 tokens.

Download SKILL.mdSave it as .claude/skills/skill-creator/SKILL.md (or your agent's skills folder).
name
skill-creator
description
Load this skill before creating, updating, or deleting a Vibe skill, or whenever you plan to add or modify SKILL.md files under a skills directory. It explains Vibe's SKILL.md frontmatter, discovery order, support files, and the permission flow.

Skill Creator

Use this when the user asks you to create, update, or delete a Vibe skill.

Gathering requirements

When creating a new skill, ask the user for the details you are missing. Ask one question at a time and wait for the answer before asking the next. Never send multiple questions in a single message — it is bewildering. Gather, in order:

  1. Name — a slug (lowercase, hyphens), e.g. run-migrations or format-changelog.
  2. Purpose / description — when should this skill load? This is the routing text the model sees.
  3. Instructions — what should the skill actually tell the model to do? Steps, conventions, commands, gotchas.

Skip any question the user has already answered. Once you have all three, confirm the scope (project vs global) if it is not obvious, then write the skill.

What a skill is

A skill is a directory containing a SKILL.md file with YAML frontmatter plus Markdown instructions. The model loads it on demand via the skill tool; a user-invocable skill is also reachable by typing /skill-name. The description is always visible for routing — the body is loaded only after the skill is selected.

Where skills live (discovery order, first match wins)

  1. skill_paths entries from config.toml
  2. .vibe/skills/ — project scope (requires a trusted folder)
  3. .agents/skills/ — project scope (requires a trusted folder)
  4. ~/.vibe/skills/ — user global
  5. ~/.agents/skills/ — user global

Precedence: built-in skills are seeded first and their names are reserved — a user skill whose name collides with a built-in is silently skipped at load time and never appears. Among the paths above, the first directory to define a given name wins; later duplicates are skipped. Built-in skills are read-only. Registry skills are materialized under VIBE_HOME and should not be hand-edited.

Choose the scope before writing: use .vibe/skills/<name>/ for a skill scoped to this project, or ~/.vibe/skills/<name>/ for one available everywhere. Ask the user which they want when it is not obvious, and write to the directory that matches the chosen scope.

Show full SKILL.md (316 more words)Show less

SKILL.md format

markdown
---
name: my-skill
description: Load this skill when ...
---

# My Skill

Instructions go here.

Frontmatter fields:

  • name (required): lowercase letters, numbers, and hyphens only (^[a-z0-9]+(-[a-z0-9]+)*$), 1–64 chars. It should match the directory name (a mismatch only logs a warning; the skill still loads under the frontmatter name). Do not reuse a built-in skill name (e.g. vibe) or a name already taken by another skill — the collision is silently skipped and the skill will not load.
  • description (required): 1–1024 chars. Say when to load the skill — this is the only text the model sees before selecting it.
  • user-invocable (optional, default true): when false the skill is model-only — hidden from the / menu and not reachable via /skill-name.
  • allowed-tools (optional, experimental): space-delimited list of pre-approved tools.
  • license, compatibility, metadata (optional): metadata only. metadata is a flat string-to-string map (e.g. display-name, short-description).

Do not invent frontmatter keys. Fields from other products (e.g. visibility, defaultEnabled) are not part of Vibe's schema and are ignored.

Support files

Keep SKILL.md focused on durable instructions. Add Markdown, plain text, CSV, JSON, or YAML support files in the same directory only when they earn their place. Reference them by path relative to the skill directory; the model reads them with read_file on demand.

Create, update, delete

  • Create: make <skills-dir>/<slug>/SKILL.md with valid frontmatter, where <skills-dir> is the directory for the chosen scope (.vibe/skills/ for project, ~/.vibe/skills/ for global). Add support files under the same directory only when useful.
  • Update: edit SKILL.md or support files in place with edit. Preserve useful existing guidance; keep the diff minimal.
  • Delete: remove the whole skill directory when asked to delete a skill. Do not delete only SKILL.md.

Applying changes

Writing under a skills directory goes through the normal write_file / edit permission prompts — there is no separate proposal step. After changes, tell the user they can run /reload to pick up the new or edited skill without restarting. Keep the final summary brief; do not paste full file contents unless the user asks.

© mistralai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in vibe/plugins/builtins/vibe/skills/skill-creator of mistralai/mistral-vibe.

Open the folder on GitHubat commit 7cb9189

Compare with similar skills

Vibe Skill Creator 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.

Vibe Skill Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vibe Skill Creator this skillmistralai/mistral-vibe5.1k—~1.2kAutomated safety check: PassApache-2.0
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Skill Creatorzhayujie/CowAgent47k—~4.7kAutomated safety check: NotesMIT
Open-Science Skill Creatoraipoch/open-science5.5k—~1.7kAutomated safety check: PassApache-2.0
Skill Quality ReviewerGalaxy-Dawn/claude-scholar5.7k1 repos~3kAutomated safety check: PassMIT
Prismer Skill CreatorPrismer-AI/PrismerCloud1.6k—~2.6kAutomated safety check: NotesMIT

Similar skills

  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    zhayujie/CowAgent

    Guides creating, installing and updating agent skills in a workspace: SKILL.md frontmatter, bundled scripts and references, with scripts to scaffold, validate and package.

    47k GitHub stars~4.7k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Open-Science Skill Creator

    aipoch/open-science

    Creates, revises, evaluates and publishes skills in the Open-Science app through its native host.skills composer, with optional test prompts and benchmarks.

    5.5k GitHub stars~1.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Skill Quality Reviewer

    Galaxy-Dawn/claude-scholar

    Scores a skill across description, content organization, writing style and structure, then produces letter grades and a prioritized improvement plan.

    5.7k GitHub starsUsed in 1 repo~3k tokens
    Agent WorkflowsAuto-check passed
  • Prismer Skill Creator

    Prismer-AI/PrismerCloud

    Walks an agent through creating, importing, editing, validating, testing and publishing Prismer Skills with a fixed workflow and bundled scripts.

    1.6k GitHub stars~2.6k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check: notes
  • Skill Factory

    sangrokjung/claude-forge

    Analyze session work and automatically convert reusable patterns into Claude Code skills.

    850 GitHub stars~2.7k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

More from mistralai/mistral-vibe

All 14 skills in this repo
  • Mistral Vibe Plugin Creator

    mistralai/mistral-vibe

    Official

    Shows how to build a Vibe plugin package in the Agent Plugins 1.0 format, with a plugin.json manifest and optional skills, MCP servers, hooks and other components.

    5.1k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Create Vibe Feature

    mistralai/mistral-vibe

    Official

    Guides feature work in the Mistral Vibe Python CLI so each change lands in the right module and matches the project's architecture decision records.

    5.1k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Official

    Plans which analytics events and properties a new feature needs, checks them against the existing event registry, and verifies them per environment.

    5.1k GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Vibe Worktree Manager

    mistralai/mistral-vibe

    Official

    Creates, reuses and cleans up git worktrees under a shared vibe home directory, with per-repo buckets, claim records and dirty-state checks before removal.

    5.1k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Write Vibe ADR

    mistralai/mistral-vibe

    Official

    Creates or updates concise Architecture Decision Records for the Mistral Vibe CLI and registers each one in the AGENTS.md decisions table.

    5.1k GitHub stars~942 tokensUpdated yesterday
    Auto-check passed
  • Write Vibe Tests

    mistralai/mistral-vibe

    Official

    Guides writing or refactoring tests for the Mistral Vibe CLI agent so they check behavior through stable boundaries, like tool invocation or saved session shape, instead of internal calls.

    5.1k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Vibe Skill Creator

What does Vibe Skill Creator do?

Guides your agent in creating, updating or deleting Mistral Vibe skills: what to ask you, where skills live, how they are discovered and the SKILL.md frontmatter rules. This skill is the built-in guide for authoring Vibe skills. When creating one, the agent asks one question at a time for the name (a lowercase slug), the purpose that serves as the routing description, and the instructions, then confirms whether the skill is project or global scope before writing.

When should I use Vibe Skill Creator?

Vibe Skill Creator fits situations like: creating a new Vibe skill for a project or for all your projects; updating or deleting an existing Vibe skill; working out why a skill is not being loaded by Vibe.

How do I install Vibe Skill Creator in Claude Code?

Run `npx skills add mistralai/mistral-vibe --skill skill-creator -a claude-code`. Or copy the skill folder (vibe/plugins/builtins/vibe/skills/skill-creator in mistralai/mistral-vibe) into .claude/skills/skill-creator in your project. Claude Code loads it when a task matches its description.

How do I install Vibe Skill Creator in Codex?

Run `npx skills add mistralai/mistral-vibe --skill skill-creator -a codex`. Or copy the skill folder (vibe/plugins/builtins/vibe/skills/skill-creator in mistralai/mistral-vibe) into .agents/skills/skill-creator in your project. Codex loads it when a task matches its description.

Can I use Vibe Skill Creator 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 mistralai/mistral-vibe --skill skill-creator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-creator, .gemini/skills/skill-creator, .github/skills/skill-creator and .opencode/skills/skill-creator in your project.

What does Vibe Skill Creator need to run?

SKILL.md names no scripts, command-line tools or credentials: Vibe Skill Creator is instructions for the agent only. Our summary lists: Mistral Vibe with a skills directory you can write to.

Does Vibe Skill Creator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Vibe Skill Creator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Vibe Skill Creator use?

Vibe Skill Creator is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vibe Skill Creator use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Vibe Skill Creator?

Skills that share tags, products or a category with Vibe Skill Creator: Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars), Skill Creator (zhayujie/CowAgent, 47k stars), Open-Science Skill Creator (aipoch/open-science, 5.5k stars) and Skill Quality Reviewer (Galaxy-Dawn/claude-scholar, 5.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vibe Skill Creator?

mistralai (a GitHub organization, an official publisher) maintains it in mistralai/mistral-vibe, which has 5,073 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 7, 2026.

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