1 files changed, 110 insertions, 0 deletions
diff --git a/dot_claude/skills/tuicr/SKILL.md b/dot_claude/skills/tuicr/SKILL.md
new file mode 100644
index 0000000..2f8e728
--- /dev/null
+++ b/dot_claude/skills/tuicr/SKILL.md
@@ -0,0 +1,110 @@
+---
+name: tuicr
+description: Review local git changes with tuicr TUI via zellij floating pane
+---
+
+# tuicr - TUI Change Reviewer
+
+Launch the `tuicr` TUI tool in a zellij floating pane to interactively review
+local git changes.
+
+## Usage
+
+```
+/tuicr [directory]
+```
+
+Or simply mention wanting to review changes with tuicr.
+
+## How It Works
+
+Since coding agents cannot run interactive TUI applications directly, this
+skill uses a zellij workaround:
+
+1. Detects if the current agent session is running inside zellij (`$ZELLIJ`).
+2. If yes: opens tuicr in a floating pane, blocks until it exits, then reads
+   any exported instructions back from a temp file.
+3. If no: instructs the user to restart the agent inside zellij.
+
+## Determining the Directory
+
+**Important:** You must determine the correct git repository directory based on
+context.
+
+Consider:
+
+- The user's current working directory
+- Any repository they've been working in during the session
+- Explicit directory mentioned in their request
+- The git status output if available
+
+Common patterns:
+
+- "review my changes" → use current working directory
+- "review changes in myproject" → find that repo path
+- After editing files → use the directory of those files
+
+## Workflow
+
+1. **Determine target directory** (cwd, recent file ops, ask if ambiguous).
+
+2. **Run the wrapper** with a 10-minute timeout:
+
+   ```bash
+   <skill-directory>/tuicr-wrapper.sh [directory]
+   ```
+
+   **IMPORTANT:** Always set `timeout: 600000` (10 minutes) on the Bash tool
+   call. The script blocks on a FIFO until tuicr exits; without the extended
+   timeout the agent may background it after 2 minutes.
+
+3. **Handle the result**:
+   - Success → tuicr opened in a floating pane, user reviewed and exited.
+   - Not in zellij → relay the instructions to the user.
+   - Not a git repo → ask for the correct path.
+
+4. **Process instructions from tuicr output**:
+
+   ```
+   === TUICR INSTRUCTIONS ===
+   <instructions here>
+   === END TUICR INSTRUCTIONS ===
+   ```
+
+   If present, parse and execute them. If absent, ask the user to paste from
+   clipboard.
+
+## Configuration
+
+| Variable          | Default    | Description                                    |
+| ----------------- | ---------- | ---------------------------------------------- |
+| `TUICR_PANE_MODE` | `floating` | `floating` (overlay) or `split` (horizontal)   |
+| `TUICR_SPLIT_DIR` | `down`     | When `split`: `down`, `up`, `right`, or `left` |
+
+Example:
+
+```bash
+TUICR_PANE_MODE=split TUICR_SPLIT_DIR=down \
+  <skill-directory>/tuicr-wrapper.sh /path/to/repo
+```
+
+## Zellij Tips (relay to user if needed)
+
+- Move focus between panes: `Alt-h/j/k/l`
+- Close the floating pane: press `q` inside tuicr (pane auto-closes)
+- Toggle floating pane visibility: `Ctrl-p` then `w`
+- Zoom current pane: `Ctrl-p` then `f`
+
+## Error Handling
+
+| Error               | Action                                                                                               |
+| ------------------- | ---------------------------------------------------------------------------------------------------- |
+| Not in zellij       | Tell the user to restart the agent inside zellij                                                     |
+| Not a git repo      | Ask user for correct directory                                                                       |
+| tuicr not installed | Tell user `tuicr` is provisioned via nix; run `home-manager switch` (VM) or `just nix-switch` (host) |
+
+## When NOT to use
+
+- User just wants `git diff` output (use git directly)
+- Reviewing remote/PR changes (use `gh` CLI or web)
+- User explicitly asks for non-interactive review