Official agent skill

Vibe Cross-Platform Rules

by mistralai in mistralai/mistral-vibe

Coding and testing rules for Mistral Vibe so code works on Linux, macOS and Windows even though CI runs the test suite on Linux only.

OfficialApache-2.0Auto-check passedDevelopment

Install Vibe Cross-Platform Rules

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

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

GitHub CLI
$ gh skill install mistralai/mistral-vibe vibe-cross-platform --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/.agents/skills/vibe-cross-platform .claude/skills/vibe-cross-platform && 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
vibe-cross-platform
GitHub stars
5.1k
Token cost
~551 tokens
SKILL.md length
241 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
Apache-2.0

At a glance

Coding and testing rules for Mistral Vibe so code works on Linux, macOS and Windows even though CI runs the test suite on Linux only.

  • Writing code that touches paths, shells or Windows-specific handling
  • SKILL.md covers Code rules, Terminal data and Testing
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Parsing terminal or PTY output that arrives in chunks

What it does

Because the machine a contributor develops on is not the one that gates the pull request, the rules require code to be correct on every platform and provably so on those CI cannot run. Code must not rely on host behavior such as shell, path separator, line endings or case sensitivity. Platform branches go through the helpers in vibe.core.utils.platform, such as is_windows and resolve_windows_shell, rather than ad hoc sys.platform checks, and paths are built with pathlib.Path.

Terminal and PTY data are treated as arbitrarily chunked streams: normalize CRLF before reading a lone carriage return as a redraw, buffer incomplete control sequences, and add regression tests that run on Linux and cover every split boundary. Tests for other platforms run on Linux by monkeypatching sys.platform, environment variables and probes like shutil.which instead of skipping them, and platform-dependent assertions must force the platform explicitly.

When your agent uses it

  • Writing code that touches paths, shells or Windows-specific handling
  • Parsing terminal or PTY output that arrives in chunks
  • Adding tests for Windows behavior that must run on Linux CI

Example prompts

  • “Add Windows shell resolution to this command runner and test it on Linux with monkeypatching.”
  • “Fix the path handling in the config loader so it works on Windows and macOS.”

Requirements

  • The Mistral Vibe repository and its platform helpers

What it can do on your machine

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

    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 Cross-Platform Rules loads about 551 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 241 words of instructions outside code blocks.

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

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 4ae5c59, republished under its Apache-2.0 licence (© mistralai). 241 words, ~551 tokens.

Download SKILL.mdSave it as .claude/skills/vibe-cross-platform/SKILL.md (or your agent's skills folder).
name
vibe-cross-platform
description
Cross-platform development rules for Mistral Vibe. Use when writing platform-specific logic, handling paths, Windows support, shell compatibility, terminal data streams, or cross-OS testing strategies.
metadata.display-name
Vibe Cross-Platform
metadata.short-description
Cross-platform rules and testing for Vibe
metadata.default-prompt
Use $vibe-cross-platform to ensure code and tests work across Linux, macOS, and Windows.

Vibe Cross-Platform

Vibe ships on Linux, macOS, and Windows, but CI runs the test suite on Linux only. The machine you develop on is not the machine that gates the PR — code and tests must pass on every platform, and must be provably correct on the platforms CI cannot exercise.

Code rules

  • Never rely on host-specific behavior (shell, path separator, line ending, available binaries, $SHELL, case sensitivity). Assume the same code runs under cmd.exe, Git Bash, zsh, and sh.
  • Branch platform-specific logic behind the helpers in vibe.core.utils.platform (is_windows(), resolve_windows_shell()), not ad-hoc sys.platform checks. Keep POSIX-only assumptions (forward slashes, POSIX shlex escaping, $SHELL) out of shared paths and scope Windows-only handling to is_windows().
  • Use pathlib.Path for path composition; never hardcode / or \\.

Terminal data

  • Treat terminal and PTY data as arbitrarily chunked streams: normalize CRLF before interpreting lone \r as an in-place redraw, buffer incomplete control sequences until their terminator arrives, and add Linux-runnable regression tests covering CRLF plus every split boundary of representative control sequences.

Testing

  • Test other-platform code paths on Linux by monkeypatching sys.platform, env vars, and probes like shutil.which — do not @pytest.mark.skipif them away. A Windows-only behavior with no Linux-runnable test is untested in CI.
  • When an assertion depends on the platform, force it explicitly (e.g. monkeypatch.setattr(module, "is_windows", lambda: True)) instead of letting the test pass only because of the host it happened to run on. A test that would flip its result on a different OS is a bug.

© 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 .agents/skills/vibe-cross-platform of mistralai/mistral-vibe.

Open the folder on GitHubat commit 4ae5c59

Compare with similar skills

Vibe Cross-Platform Rules 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 Cross-Platform Rules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vibe Cross-Platform Rules this skillmistralai/mistral-vibe5.1k—~551Automated safety check: PassApache-2.0
Apple Container Test RunnerRustPython/RustPython22k—~467Automated safety check: PassMIT
Native Feel Cross Platform Desktopyetone/native-feel-skill1.9k1 repos~1.5kAutomated safety check: PassMIT
JS Cpp Protocolnotepadqq/notepadqq2.3k—~3.2kAutomated safety check: PassGPL-3.0
Coding Best PracticesKartikLabhshetwar/better-shot2.4k2 repos~1.8kAutomated safety check: PassCustom licence
Experiment Iterative CoderEvoScientist/EvoSkills4783 repos~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Apple Container Test Runner

    RustPython/RustPython

    Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.

    22k GitHub stars~467 tokensUpdated today
    Testing & QAAuto-check passed
  • Native Feel Cross Platform Desktop

    yetone/native-feel-skill

    A skill your agent uses when the user is designing, prototyping, or rewriting a desktop app that must run on multiple OSes (macOS + Windows, optionally Linux) AND feel indistinguishable from a…

    1.9k GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed
  • JS Cpp Protocol

    notepadqq/notepadqq

    Reference for the communication protocol between the JavaScript editor (CodeMirror or Monaco) and the C++/Qt UI layer via QWebChannel.

    2.3k GitHub stars~3.2k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Coding Best Practices

    KartikLabhshetwar/better-shot

    Reviews macOS Swift 6+ code for modern idioms, SOLID principles, SwiftData patterns, and concurrency best practices.

    2.4k GitHub starsUsed in 2 repos~1.8k tokens
    DevelopmentAuto-check passed
  • Experiment Iterative Coder

    EvoScientist/EvoSkills

    Iterative code refinement through plan → code → evaluate → refine cycles.

    478 GitHub starsUsed in 3 repos~2.5k tokens
    DevelopmentAuto-check passed
  • Advances RStudio's pinned copilot-language-server dependency to a specified release, then uploads it to S3, verifies the install, and opens a PR.

    5.1k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed

More from mistralai/mistral-vibe

All 15 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.4k 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

Questions about Vibe Cross-Platform Rules

What does Vibe Cross-Platform Rules do?

Coding and testing rules for Mistral Vibe so code works on Linux, macOS and Windows even though CI runs the test suite on Linux only. Because the machine a contributor develops on is not the one that gates the pull request, the rules require code to be correct on every platform and provably so on those CI cannot run. Code must not rely on host behavior such as shell, path separator, line endings or case sensitivity.

When should I use Vibe Cross-Platform Rules?

Vibe Cross-Platform Rules fits situations like: writing code that touches paths, shells or Windows-specific handling; parsing terminal or PTY output that arrives in chunks; adding tests for Windows behavior that must run on Linux CI.

How do I install Vibe Cross-Platform Rules in Claude Code?

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

How do I install Vibe Cross-Platform Rules in Codex?

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

Can I use Vibe Cross-Platform Rules 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 vibe-cross-platform -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vibe-cross-platform, .gemini/skills/vibe-cross-platform, .github/skills/vibe-cross-platform and .opencode/skills/vibe-cross-platform in your project.

What does Vibe Cross-Platform Rules need to run?

SKILL.md names no scripts, command-line tools or credentials: Vibe Cross-Platform Rules is instructions for the agent only. Our summary lists: The Mistral Vibe repository and its platform helpers.

Does Vibe Cross-Platform Rules 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 Cross-Platform Rules 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 Cross-Platform Rules use?

Vibe Cross-Platform Rules 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 Cross-Platform Rules use?

About 551 tokens (SKILL.md is roughly 2.2k 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 Cross-Platform Rules?

Skills that share tags, products or a category with Vibe Cross-Platform Rules: Apple Container Test Runner (RustPython/RustPython, 22k stars), Native Feel Cross Platform Desktop (yetone/native-feel-skill, 1.9k stars), JS Cpp Protocol (notepadqq/notepadqq, 2.3k stars) and Coding Best Practices (KartikLabhshetwar/better-shot, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vibe Cross-Platform Rules?

mistralai (a GitHub organization, an official publisher) maintains it in mistralai/mistral-vibe, which has 5,087 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 9, 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.