IMPORTANT: To view this page as Markdown, append `.md` to the URL (e.g. /docs/manual/basics.md). For the complete Mojo documentation index, see llms.txt.
Skip to main content
Version: Nightly
For the complete Mojo documentation index, see llms.txt. Markdown versions of all pages are available by appending .md to any URL (e.g. /docs/manual/basics.md).

Mojo AI skills

Mojo is ideal for agentic programming because it has a concise language syntax and your agent will catch most of the coding errors at compile time. To make your token usage even more efficient, our Mojo skills ensure that you generate up-to-date and idiomatic Mojo code from the start.

Many AI models are trained on older versions of Mojo and MAX. They aren't updated as quickly as the language evolves, so they often generate code that doesn't compile or reflects outdated usage.

For best results, agents need accurate, up-to-date context. Mojo agent skills are designed to be compact and focused, providing only the most important guidance needed to avoid common code generation issues. This keeps token usage low and leaves more room for relevant context.

Modular skills provide current guidance on Mojo syntax, development patterns, and workflows so AI coding agents generate modern, working code that aligns with the language today.

What you can do with this

  • Start new Mojo or MAX projects without manual setup ("I want to start a new Mojo project for image enhancement")
  • Generate modern Mojo syntax ("Write a function that applies a transformation around the center")
  • Write GPU code using valid patterns ("Convert this CPU function to run on GPU")
  • Use Python interoperability correctly ("Update this Mojo code to use NumPy")
  • Port code from CUDA, Python, or C++ ("Convert this CUDA function to Mojo")

You describe the goal. Your system handles the language.

Installation

Install all skills:

npx skills add modular/skills

Install a specific skill:

npx skills add modular/skills --skill mojo-syntax

Update skills:

npx skills update

Manual installation

HTTPS:

git clone https://github.com/modular/skills.git

SSH:

git clone git@github.com:modular/skills.git

CLI:

gh repo clone modular/skills

Configuration

Copy or symlink individual skill files into your agent's configuration directory.

How it works

Skills follow the Agent Skills Standard. Each skill is self-contained, triggered by intent, and structured for reliable use by AI agents.

At runtime:

  1. The agent interprets your request.
  2. It selects the right skill (for example, mojo-syntax or mojo-gpu-fundamentals).
  3. The skill guides generation toward current Mojo and MAX patterns.

This isn't prompting. It's controlled code generation.

Connect to the docs MCP server

Connect the docs Model Context Protocol (MCP) server to give your AI assistant live access to Mojo's documentation. Your assistant can search Mojo's manual, API references, and code examples while it plans, writes, and debugs your code, so its answers stay grounded in the current documentation instead of its training data.

Your assistant can usually set up the MCP server itself with a prompt like this:

Add the Mojo docs MCP server at https://mojo-mcp.modular.com/mcp/ and verify it
by searching the docs.

Or configure it manually in your tool's settings.

With Claude Code, add the server from the command line:

claude mcp add --transport http mojo-docs https://mojo-mcp.modular.com/mcp/

With Cursor, add the server to ~/.cursor/mcp.json:

{
"mcpServers": {
"mojo-docs": {
"url": "https://mojo-mcp.modular.com/mcp/"
}
}
}

Any other client that supports MCP's streamable HTTP transport connects with the same URL. The server indexes both the stable and nightly documentation.

FAQ

Are the skills always up to date with the latest Mojo?

Skills are updated regularly to track changes in Mojo and MAX, but there will be lag between language changes and skill updates.

Can I select a skill version that matches my installed Mojo version?

Not currently. Skills aren't versioned by Mojo release, so there may be mismatches between the skill's guidance and your installed version. We recommend installing the latest version of Mojo to minimize this risk.

Do I have to install all the skills?

No. Install only what you need.

Are the skills licensed?

Yes. They're available under the Apache 2.0 license.