illusion-usagelisted
Install: claude install-skill YunTaiHua/illusion-agent
# Illusion Agent Usage: Agent Dual-Role Guide
This skill serves two scenarios. **Detect your role first**, then follow the matching track.
> **Live documentation**: ALWAYS fetch the latest docs from GitHub before acting — do not rely on hardcoded commands in this skill. Repo: `https://github.com/YunTaiHua/illusion-agent`. Docs: `https://github.com/YunTaiHua/illusion-agent/tree/main/docs`. Use `WebFetch`, `web_fetch`, or an equivalent tool to read the URLs in [Reference URLs](#reference-urls) below.
## Role Detection
| Your situation | Track to follow |
|----------------|-----------------|
| You (the agent) will invoke `illusion -p` as a subprocess to do coding tasks autonomously | **Track A: Agent-Driven Print Mode** |
| Your human master wants to install/use Illusion Agent themselves, and you guide them | **Track B: Human-Friendly TUI & Web** |
| Both — you'll drive it AND teach your master | Read both tracks; Track A for your own use, Track B for your master |
---
# Track A: Agent-Driven Print Mode
Use print mode when YOU (the agent) operate Illusion Agent as a non-interactive subprocess. Every `-p` invocation is an atomic request-response — no waiting for interactive input within the same turn.
## A.0 Fetch Current Docs (MANDATORY before install)
Use a web fetch tool to read these in order. This skill only outlines the workflow — concrete flags, file paths, and auth providers may have changed.
1. **README** — `https://github.com/YunTaiHua/illusion-agent`
2. **Get