RightNow Agent skills are reusable instruction packages for repeatable workflows. Each skill is a directory with a SKILL.md file and optional supporting scripts or references.
A skill starts with YAML frontmatter. The name identifies the skill, and the description tells RightNow what it does and when automatic invocation is appropriate.
---
name: review-pr
description: Review a pull request for correctness and regressions. Use when the user asks for a PR review.
---
# Review pull request
1. Read the changed files.
2. Identify correctness, security, and regression risks.
3. Report findings with file and line evidence.| Field | Purpose |
|---|---|
| name | Lowercase identifier. Spaces and underscores normalize to hyphens. |
| description | Explains the workflow and its trigger conditions. |
| when-to-use | Optional trigger phrases kept separate from the description. |
| user-invocable | Controls whether the skill appears as a slash command. Defaults to true. |
| disable-model-invocation | Set true to require explicit slash invocation. |
| Location | Scope | Priority |
|---|---|---|
| ./.rightnow/skills/ | Current directory | Highest |
| <repo>/.rightnow/skills/ | Repository | Medium |
| ~/.rightnow/skills/ | User | Lowest native |
| .agents/skills/ | Discovered at the same directory tiers | Tier-relative |
| bundled and plugins | Platform or installed extension | Native skills keep precedence over same-named bundled skills |
RightNow also discovers flat command Markdown under corresponding commands/ directories. Existing project .grok/skills/ and .grok/commands/ remain fallbacks when the preferred directory is absent.
/name and place arguments after the command.disable-model-invocation: true when only an explicit slash command should activate it./review-pr 123
/local:commit
/repo:commit
/user:commit
/acme:loginWhen a name collides with another skill or built-in command, both stay invocable. The built-in keeps the bare name, while the skill is qualified by local, repo, user, or plugin scope.
The shipped profile sets compat.claude.skills = false and compat.cursor.skills = false. Machine-wide Claude and Cursor skill imports are therefore off. Native RightNow skills remain available.
rightnow-pager.exe inspect
rightnow-pager.exe inspect --json