Skip to main content
Skills are modular, prompt-driven packages that teach your AI coding agents how to best leverage Unblocked. Each MCP tool has a corresponding skill — where tools provide capabilities, skills provide the judgment to use them well, encoding when to reach for each tool, how to write effective queries, and how to interpret results. Skills follow the open Agent Skills specification, work across Claude Code, Cursor, Windsurf, and other supported agents, and are open-source in the unblocked/skills repository.

​
Install

​
Quick install (macOS)

The macOS install script installs skills automatically alongside the MCP server: 
curl -fsSL https://getunblocked.com/install-mcp.sh | bash

​
Other methods

If the Unblocked CLI is already installed, you can install or update skills separately:
unblocked install-skills

​
How skills are installed

Skills are stored in a canonical location at ~/.agents/skills/ and symlinked into each agent’s own skills directory (e.g. ~/.claude/skills/, ~/.cursor/skills/, ~/.codeium/windsurf/skills/). The installer auto-detects which agents you have installed and configures all of them.

​
Automatic updates

Skills are automatically kept up to date. Each time the Unblocked CLI runs, it fetches the latest skills from GitHub and writes them to ~/.agents/skills/. If you modify a skill locally, Unblocked detects the change and stops updating that specific skill so your customizations are never overwritten.

​
Cookbook

The Unblocked Cookbook contains ready-made recipes that compose Unblocked skills for specific scenarios. Recipes are designed to be forked and customized for your environment. Available recipes include workflows for code review, planning, ticket enrichment, bug validation, incident investigation, and more — in both interactive and headless variants. To use a recipe, copy its directory into your project’s skills folder: 
cp -r recipes/<recipe-name> .claude/skills/<recipe-name>
See the cookbook repository for the full list of recipes and instructions for running them in CI/CD.