Skip to main content

Module skill_commands

Module skill_commands 

Source
Expand description

Skill-backed slash commands for the TUI (Goal 169).

A skill is a Markdown file with optional YAML front-matter that describes a reusable prompt template. Every *.md file found in the standard skill directories is automatically registered as a /name slash command.

§Search paths (priority order — first name wins on collision)

  1. <workspace>/.recursive/skills/ — project-level (committed to repo)
  2. ~/.recursive/skills/ — user-level (global)
  3. Built-in commands from CommandRegistry::default_set() (never shadowed by skills)

§Skill file format

---
name: refactor          # defaults to filename stem
description: Refactor the selected code for clarity
aliases: [rf]
argument_hint: "<file-or-description>"
allowed_tools: [read_file, apply_patch, run_shell]
---

Refactor the following with these goals:
- Single responsibility

$ARGUMENTS

$ARGUMENTS (or {{args}}) is replaced with whatever the user types after the command name.

Structs§

SkillCommand
A skill-backed slash command parsed from a .md file.
SkillCommandLoader
Loads SkillCommands from the standard search paths.