refly skill run --id skpi-sww12wxvy9zbfr1wwx35gybm --input '{
  "query": "Your question here"
}'

Step 2: Wait for Completion

refly workflow status c-xz42o3itzw4bdnnhoovb16dv --watch --interval 10000

Step 3: Get the Run ID

refly workflow runs c-xz42o3itzw4bdnnhoovb16dv --limit 1

Look for runId in the output (format: we-xxx).

Step 4: Get the Result ID

refly workflow detail <RUN_ID>

Look for resultId in the skillResponse node (format: ar-xxx).

Step 5: Extract the Content

refly workflow result <RESULT_ID> --include-messages --raw

The AI response is in .payload.messages[] where type is "ai". Extract with:

refly workflow result <RESULT_ID> --include-messages --raw | jq -r '.payload.messages[] | select(.type=="ai") | .content'

Alternative: One-liner (after Step 2)

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`

# 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:

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

perplexity

Perplexity

Input

Execution

Step 1: Run the Skill