Relay Set

Configure Relay defaults for the current project. Settings are stored in .relay/config.json in the coding agent's startup directory.

This skill only changes Relay defaults. It does not change the core pass/pickup handoff behavior in ../relay/SKILL.md.

Built-in defaults when .relay/config.json does not exist:

{
  "storage": "project",
  "detail": "compact"
}

Accepted storage words:

• project, .relay, keep, persist: set storage to project.
• tmp, temp, /tmp, temporary: set storage to temp.

Accepted detail words:

• compact, brief, short, concise: set detail to compact.
• full, detailed, detail: set detail to full.

Common defaults to recommend:

• /relay-set compact project: the default high-signal everyday setting.
• /relay-set full project: the best default when the team prefers maximum relay fidelity.
• /relay-set compact temp: closest to Matt-style disposable handoffs.
• /relay-set full temp: detailed but intentionally one-shot.

Examples:

/relay-set full temp
/relay-set compact project
/relay-set tmp
/relay-set full

If the user provides both storage and detail words in any order, set both. If the user provides only one, update only that setting and preserve the other current setting.

If the user provides no arguments, or asks to show settings, read .relay/config.json if present and report the effective settings. If the file is missing, report the built-in defaults.

If the user asks to reset settings, write the built-in defaults to .relay/config.json.

When explaining settings to the user:

• project + compact means structured everyday Relay with project-local storage.
• project + full means maximum-fidelity Relay kept under .relay/.
• temp + compact means disposable lightweight handoffs.
• temp + full means disposable but very detailed handoffs.

When writing settings:

1. Create .relay/ if needed.
2. Preserve valid existing settings that were not overridden.
3. Write .relay/config.json as compact JSON with exactly these keys:

{"storage":"project","detail":"compact"}

Use only these values:

• storage: project or temp
• detail: compact or full

After writing settings, tell the user the effective defaults and the config path.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: RiAnBee
• Source: RiAnBee/relay-skill
• License: MIT

Install and usage instructions live in the source repository linked above.