fix(perplexity): update execution instructions and fix common errors

- Simplify workflow to match simplified Perplexity workflow (removed batch queries)
- Replace broken toolcalls approach with reliable workflow result method
- Add clear 5-step execution guide with explanations
- Add Key Concepts table explaining workflowId, runId, resultId
- Add Common Mistakes section warning against .output.preview approach
- Fix JSON path for extracting runId (.payload.runs[0].runId)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: alchemistklk

skills/perplexity/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: perplexity
-description: "AI-powered search and chat with Perplexity. Use when you need to: (1) get AI responses with real-time web search, (2) perform batch research queries, or (3) answer questions with up-to-date information."
+description: "AI-powered search and chat with Perplexity. Use when you need to: (1) get AI responses with real-time web search, or (2) answer questions with up-to-date information."
 version: 1.0.0
 skillId: skp-rkmnjbtpxxpidhck89q60yvt
 workflowId: c-xz42o3itzw4bdnnhoovb16dv
@@ -10,52 +10,99 @@ category: text-data
 
 # Perplexity
 
-AI-powered search and chat with Perplexity. Use when you need to: (1) get AI responses with real-time web search, (2) perform batch research queries, or (3) answer questions with up-to-date information.
+AI-powered search and chat with Perplexity. Use when you need to: (1) get AI responses with real-time web search, or (2) answer questions with up-to-date information.
 
 ## Input
 
 Provide input as JSON:
 
 ```json
 {
-  "query": "Search query or chat message for single query processing",
-  "queries": "Array of queries for batch search (comma-separated or JSON array format)"
+  "query": "Your search query or question"
 }
 ```
 
-## Execution (Pattern B: Text/Data)
+## Execution
 
-### Step 1: Run the Skill and Get Run ID
+### Step 1: Run the Skill
 
 ```bash
-RESULT=$(refly skill run --id skpi-sww12wxvy9zbfr1wwx35gybm --input '{
-  "query": "What are the latest AI trends in 2024?"
-}')
-RUN_ID=$(echo "$RESULT" | jq -r '.payload.workflowExecutions[0].id')
-# RUN_ID is we-xxx format, use this for workflow commands
+refly skill run --id skpi-sww12wxvy9zbfr1wwx35gybm --input '{
+  "query": "Your question here"
+}'
 ```
 
-### Step 2: Open Workflow in Browser and Wait for Completion
+### Step 2: Wait for Completion
 
 ```bash
-open "https://refly.ai/workflow/c-xz42o3itzw4bdnnhoovb16dv"
-refly workflow status "$RUN_ID" --watch --interval 30000
+refly workflow status c-xz42o3itzw4bdnnhoovb16dv --watch --interval 10000
 ```
 
-### Step 3: Extract Text Content
+### Step 3: Get the Run ID
 
 ```bash
-# Get text content from toolcalls
-CONTENT=$(refly workflow toolcalls "$RUN_ID" --files --latest | jq -r '.payload.nodes[].content')
-echo "$CONTENT"
+refly workflow runs c-xz42o3itzw4bdnnhoovb16dv --limit 1
 ```
 
-## Expected Output
+Look for `runId` in the output (format: `we-xxx`).
 
-- **Type**: Text content
-- **Format**: AI-generated response with real-time web search results and citations
-- **Action**: Display content to user
+### Step 4: Get the Result ID
+
+```bash
+refly workflow detail <RUN_ID>
+```
+
+Look for `resultId` in the `skillResponse` node (format: `ar-xxx`).
+
+### Step 5: Extract the Content
+
+```bash
+refly workflow result <RESULT_ID> --include-messages --raw
+```
+
+The AI response is in `.payload.messages[]` where `type` is `"ai"`. Extract with:
+
+```bash
+refly workflow result <RESULT_ID> --include-messages --raw | jq -r '.payload.messages[] | select(.type=="ai") | .content'
+```
 
-## Rules
+### Alternative: One-liner (after Step 2)
 
-Follow base skill workflow: `~/.claude/skills/refly/SKILL.md`
+```bash
+RUN_ID=$(refly workflow runs c-xz42o3itzw4bdnnhoovb16dv --limit 1 | jq -r '.payload.runs[0].runId') && \
+RESULT_ID=$(refly workflow detail "$RUN_ID" | jq -r '.payload.nodes[] | select(.nodeType=="skillResponse") | .resultId') && \
+refly workflow result "$RESULT_ID" --include-messages --raw | jq -r '.payload.messages[] | select(.type=="ai") | .content'
+```
+
+## Key Concepts
+
+| ID Type | Format | How to Get | Used For |
+|---------|--------|------------|----------|
+| workflowId | `c-xxx` | In SKILL.md frontmatter | `workflow status`, `workflow runs` |
+| runId | `we-xxx` | From `workflow runs` or `workflow status` output | `workflow detail`, `workflow toolcalls` |
+| resultId | `ar-xxx` | From `workflow detail` → nodes[].resultId | `workflow result` |
+
+## Common Mistakes to Avoid
+
+### Do NOT use `toolcalls` with `.output.preview`
+
+```bash
+# WRONG - This will fail!
+refly workflow toolcalls <RUN_ID> --latest | jq -r '.payload.toolCalls[-1].output.preview | fromjson | .data.response'
+```
+
+**Why it fails:**
+- `.output.preview` may be `null` → jq error: `null (null) only strings can be parsed`
+- `.output.preview` may be truncated → jq error: `Unfinished string at EOF`
+- The preview field is not guaranteed to exist
+
+**Always use this instead:**
+```bash
+refly workflow result <RESULT_ID> --include-messages --raw | jq -r '.payload.messages[] | select(.type=="ai") | .content'
+```
+
+## Expected Output
+
+- **Type**: Text content with citations
+- **Format**: AI-generated response from Perplexity with web search results
+- **Action**: Display content to user