Skip to content
RightNow
Skip to article
Docs navigation: RightNow Agent / Skills

Skills

DocsRightNow AgentSkills Updated

View as Markdown
Release status

RightNow Agent, the terminal coding agent, is paused. Its guides stay online as reference.

A skill is a folder with a SKILL.md file. RightNow Agent runs it as a slash command, or loads it when a task matches its description.

Create a skill

Save this file as ./.rightnow/skills/review-pr/SKILL.md.

Text
---
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.
FieldPurpose
nameLowercase letters, digits, and hyphens, up to 64 characters; other characters become hyphens. Defaults to the directory name.
descriptionWhat the skill does and when to use it; drives automatic invocation. Up to 1,024 characters. Defaults to the first body paragraph.
when-to-useOptional trigger phrases kept separate from the description.
user-invocableSet to false to hide the slash command. Default true.
disable-model-invocationSet to true to allow only explicit slash invocation. Default false.
allowed-toolsLists the tools the skill uses. A YAML list or a comma- or space-separated string.
argument-hintShows argument guidance in slash-command autocomplete.
modelAccepts a model override value in frontmatter.
effortAccepts a reasoning-effort override value in frontmatter.
licenseRecords a license identifier.
compatibilityRecords environment requirements.
metadataStores string key-value pairs; author and short-description are promoted for display.

RightNow Agent 1.0.5 has no built-in /create-skill command, so create the folder and file yourself. Skills reload when their files change on disk.

Discovery locations

Location, highest priority firstLoads by default
.rightnow/skills/ and .agents/skills/ from the current directory up to the repository rootYes
~/.rightnow/skills/ and ~/.agents/skills/ for the userOnly with machine_wide = true
.claude/skills/ and .cursor/skills/, project and homeNo
[skills] paths entriesYes
Server-synced and bundled platform skills, when presentYes
skills/ in an enabled pluginProject plugins yes; user plugins only with machine_wide = true

Flat *.md files in a matching commands/ directory become slash commands too. Project discovery scans current and legacy directories together, then applies name and scope precedence.

Shipped setting

The shipped configuration sets compat.claude.skills = false and compat.cursor.skills = false, which turns off automatic personal skill discovery, including native RightNow skills in ~/.rightnow/skills/ and user plugin skills; project skills, [skills] paths, and server and bundled skills still load. Set machine_wide = true under [skills] to turn it on; a compat value of true also does, and scans that tool's folders.

TOML
[skills]
machine_wide = true             # load ~/.rightnow/skills/ and user plugin skills
paths = ["~/team-skills"]       # extra SKILL.md files or folders
ignore = ["~/team-skills/wip"]  # hide skills under these paths
disabled = ["wip-skill"]        # keep listed, never loaded

Slash and automatic invocation

Text
/review-pr 123
  • Type /name and any arguments to run a user-invocable skill.
  • RightNow may also invoke a skill when the prompt matches its description or when-to-use, unless disable-model-invocation: true.
  • A higher-priority native skill shadows a same-named skill from a lower-priority scope. A same-scope duplicate takes its directory name when that name is free.
  • If a skill collides with a built-in command, the built-in keeps the bare name and the skill uses a unique local, repo, user, or plugin-qualified name such as /repo:commit or /acme:login.

Inspect discovered skills

PowerShell
rightnow inspect
rightnow inspect --json

Inspect shows discovered skills even when runtime settings keep them inactive; skills from a turned-off compatibility source are tagged [disabled].

Related guides

Continue with Plugins, Hooks, or MCP Servers. For discovery failures, see Troubleshooting.