Felo SuperAgent Skill

Constraints (MUST READ FIRST)

These rules are mandatory. Violating any of them will produce incorrect behavior.

1. ALWAYS use --json flag. The script MUST run in JSON mode (--json). In Claude Code's Bash tool, stdout is always captured — it never streams directly to the user. JSON mode returns the full answer in a structured response that Claude can then output as text. State IDs are extracted from the JSON response fields thread_short_id and live_doc_short_id.

2. ALWAYS output the answer directly as text. After the script finishes, read data.answer from the JSON output and print it verbatim as your response text. Do NOT summarize, paraphrase, or add commentary around it. Output it exactly as-is so the user sees the full content. Then, if data.image_urls is non-empty, append image links immediately after, formatted as one line per image: [title](url).

3. --live-doc-id is REQUIRED when creating a conversation. Never call run_superagent.mjs without --live-doc-id. If you do not have one yet, obtain it first (see Step 2 below).

4. Reuse live_doc_id from ANY source. If you already have a live_doc_id from any previous operation in this session — whether from a prior SuperAgent call, a felo-livedoc skill operation, user-provided input, or any other skill — use it directly. Do NOT request the LiveDoc list again. Only fetch the list when no live_doc_id is available from any source. (Note: live_doc_id corresponds to the API field live_doc_short_id and the [state] output key live_doc_short_id.)

5. One LiveDoc per session. All conversations within a session MUST use the same --live-doc-id. Do NOT create a new LiveDoc unless the user explicitly asks to "open a new canvas" / "start a new LiveDoc" / "create a new workspace".

6. Default behavior is follow-up, not new conversation. After the first question, every subsequent user message is a follow-up. You MUST pass --thread-id from the previous response. Only omit --thread-id (to start a new thread on the same LiveDoc) when:

   • The user explicitly says "new topic" / "change subject" / "start over"
   • The user's intent requires a specific --skill-id (e.g., tweet writing, logo design, product image) and the current thread was not created with that skill — because --skill-id only takes effect in new conversations