Skills shelf
Skills inject specialized workflow instructions, rules, and domain-specific knowledge directly into your agent turn using the / trigger.
Invoking skills in the composer
Type / anywhere in the Ruru prompt composer. Ruru opens the skills shelf autocompletion popover, filtering available skills in real time as you type.
Press Tab or Return to accept a skill. It attaches to the turn as a context tag, injecting the skill's system instructions into the prompt turn.
Skill directories
Ruru reads skills from the exact shelf the selected CLI agent reads:
1. Shared skills directory
Skills located in ~/.agents/skills/ are globally visible and accessible regardless of which agent or model is currently active.
2. Per-agent skill roots
Ruru also loads skills from the active agent's dedicated configuration folder:
~/.claude/skills/(for Claude Code)~/.codex/skills/(for Codex)~/.cursor/skills/(for Cursor Agent)~/.antigravity/skills/(for Antigravity)
Creating a custom skill
A skill is simply a folder containing a SKILL.md file with frontmatter metadata:
---
name: pr-review
description: Review GitHub pull request code against team standards
---
You are a senior reviewer. Analyze the code for:
1. Security vulnerabilities and edge cases
2. Performance regressions
3. Clean TypeScript and React patterns