Skip to content

skill-install-run.md

Latest commit

 

History

History
118 lines (79 loc) · 2.61 KB

skill-install-run.md

File metadata and controls

118 lines (79 loc) · 2.61 KB

Rally Skill Install/Run

This document describes Rally's wrapper entrypoint for harness slash commands.

Install Targets

Install wrapper artifacts for one harness:

rally skill install --target codex

Install for all supported harnesses:

rally skill install --target all

Supported targets:

  • codex -> ~/.codex/skills/rally/SKILL.md
  • droid -> ~/.factory/skills/rally/SKILL.md
  • pi -> ~/.pi/agent/skills/rally/SKILL.md
  • claude-code -> ~/.claude/skills/rally/SKILL.md

Each wrapper is Rally-managed content and delegates back to:

rally skill agent-howto "$@"

Wrapper Behavior

The generated /rally wrapper is intentionally thin:

  • accepts wrapper arguments unchanged
  • forwards arguments to rally skill agent-howto
  • keeps the mutable prompt in Rally source code (prompts/skill-agent-howto.md)
  • keeps orchestration logic centralized in Rally

Examples:

  • /rally
  • /rally build
  • /rally build reviewer
  • /rally <invite-code>

rally skill Patterns

agent-howto prints the current instruction loop and exact follow-up run command:

rally skill agent-howto
rally skill agent-howto implement todos/create-todo.md implement

run and exec are equivalent:

rally skill run
rally skill exec

Resolution precedence:

  1. explicit args (--session, --as, positional selectors)
  2. invite token (for example rly:<session>:<agent>, rally://<session>/<agent>)
  3. saved workspace context (~/.rally/skill-context.json)
  4. interactive fallback prompt

Backward compatibility note:

  • If skill-context.json is missing, Rally falls back to reading legacy command-context.json.

Troubleshooting with Doctor

Inspect current installation health:

rally skill doctor --target all

Doctor reports per target:

  • environment/path availability
  • wrapper presence
  • managed/unmanaged file state
  • managed content drift

For preview mode:

rally skill doctor --target all --dry-run

Uninstall Behavior

Remove Rally-managed wrappers only:

rally skill uninstall --target all

Unmanaged user files are never removed.

Preview removal decisions:

rally skill uninstall --target all --dry-run

Mapping to Rally Core Commands

Wrappers map to Rally core loop behavior through rally skill run, which then joins/polls existing session workflows:

  • registration path: rally join --session <name> --as <agent> (as needed)
  • instruction polling path: rally next --session <name> --as <agent>
  • review flow remains canonical under rally build checkpoint|review
  • plan actions remain canonical under rally plan ...