AugmentClaude

refly

Base skill for Refly ecosystem: creates, discovers, and runs domain-specific skills bound to workflows. Routes user intent to matching domain skills via symlinks, delegates execution to Refly backend. Use when user asks to: create skills, run workflows, automate multi-step tasks, or manage pipelines. Triggers: refly, skill, workflow, run skill, create skill, automation, pipeline. Requires: @refly/cli installed and authenticated.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up β€” so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.

    This copies the whole skill folder into ~/.claude/skills/refly-refly-ai/ β€” the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates β€” they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description β€” no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the β€œWhat this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

Base skill for Refly ecosystem: creates, discovers, and runs domain-specific skills bound to workflows. Routes user intent to matching domain skills via symlinks, delegates execution to Refly backend. Use when user asks to: create skills, run workflows, automate multi-step tasks, or manage pipelines. Triggers: refly, skill, workflow, run skill, create skill, automation, pipeline. Requires: @refly/cli installed and authenticated.

What this skill does

Refly

Rules

  1. CLI only - Use refly <command>, never call API directly.
  2. Trust JSON - Only trust CLI JSON (ok, payload, error, hint).
  3. No fabricated IDs - Never invent workflow/run/node IDs.
  4. No tokens - Never print or request auth tokens.
  5. Stop on error - If ok=false, stop and show hint.

Available Commands

CommandID FormatDescription
refly status-Check authentication and connection status
refly login-Authenticate with Refly
refly skill list-List all available skills in the marketplace
refly skill installations-List your installed skills (get installationId here)
refly skill run --id <installationId> --input '<json>'skpi-xxxRun an installed skill, returns runId (we-xxx)
refly workflow status <runId> --watchwe-xxxWatch workflow execution status
refly workflow detail <runId>we-xxxGet workflow run details
refly workflow toolcalls <runId> --files --latestwe-xxxGet files from latest toolcall
refly file download <fileId> -o <path>df-xxxDownload a file

Tip: Get installationId (skpi-xxx) from refly skill installations.

Command Options

CommandOptionDescription
workflow status--watchPoll until workflow completes
workflow status--interval <ms>Polling interval in milliseconds (default: 5000)
workflow toolcalls--filesReturn simplified output with only files and content
workflow toolcalls--latestWith --files, return only files from the most recent toolcall
workflow toolcalls--rawDisable output sanitization (show full tool outputs)

Recommended: Use --files --latest to get files from the final output without processing all toolcalls.

Skill Categories & Execution Patterns

Choose the execution pattern based on the skill's output type:

CategorySkillsOutputPattern
File Generationimage, video, audio skillsFiles (png/mp4/mp3)Run β†’ Wait β†’ Download β†’ Open
Text/Datasearch, research, report skillsText contentRun β†’ Wait β†’ Extract content
Actionemail, messaging, integration skillsStatus confirmationRun β†’ Wait β†’ Confirm

Pattern A: File Generation Skills

Use for: nano-banana-pro, fal-image, fal-video, fal-audio, seedream-image, kling-video, wan-video

# Step 1: Run and capture RUN_ID
RESULT=$(refly skill run --id <installationId> --input '<json>')
RUN_ID=$(echo "$RESULT" | jq -r '.payload.workflowExecutions[0].id')

# Step 2: Wait for completion
refly workflow status "$RUN_ID" --watch --interval 30000

# Step 3: Get files and download to Desktop
FILES=$(refly workflow toolcalls "$RUN_ID" --files --latest | jq -r '.payload.files[]')
echo "$FILES" | jq -c '.' | while read -r file; do
  FILE_ID=$(echo "$file" | jq -r '.fileId')
  FILE_NAME=$(echo "$file" | jq -r '.name')
  if [ -n "$FILE_ID" ] && [ "$FILE_ID" != "null" ]; then
    refly file download "$FILE_ID" -o "$HOME/Desktop/${FILE_NAME}"
    open "$HOME/Desktop/${FILE_NAME}"
  fi
done

Pattern B: Text/Data Skills

Use for: jina, perplexity, weather-report, exa, research skills

# Step 1: Run and capture RUN_ID
RESULT=$(refly skill run --id <installationId> --input '<json>')
RUN_ID=$(echo "$RESULT" | jq -r '.payload.workflowExecutions[0].id')

# Step 2: Wait for completion
refly workflow status "$RUN_ID" --watch --interval 30000

# Step 3: Extract text content from toolcalls
CONTENT=$(refly workflow toolcalls "$RUN_ID" --files --latest | jq -r '.payload.nodes[].content')
echo "$CONTENT"

Pattern C: Action Skills

Use for: send-email, slack, microsoft-teams, zoom, calendar, CRM integrations

# Step 1: Run and capture RUN_ID
RESULT=$(refly skill run --id <installationId> --input '<json>')
RUN_ID=$(echo "$RESULT" | jq -r '.payload.workflowExecutions[0].id')

# Step 2: Wait for completion
refly workflow status "$RUN_ID" --watch --interval 30000

# Step 3: Confirm action status
STATUS=$(refly workflow detail "$RUN_ID" | jq -r '.payload.status')
echo "Action completed with status: $STATUS"

ID Types:

ID FormatExampleUsed For
skpi-xxxskpi-h9kpmts9ho1kl9l1sohaloeuskill run --id only
we-xxxwe-abc123def456workflow status, workflow detail, workflow toolcalls
c-xxxc-g6emwcpi1wpalsz6j4gyi3d9Browser URL only
df-xxxdf-b3yxyelshtwsbxbrkmcqxmx9file download
skpe-xxxskpe-qga5lpyv59yjzz2ghz2iv9bu⚠️ Do NOT use for workflow commands

Required behavior:

  • skill run returns RUN_ID (we-xxx) in .payload.workflowExecutions[0].id
  • Use we-xxx for all workflow commands (status, detail, toolcalls)
  • Choose execution pattern (A/B/C) based on skill category
  • File skills: Download to ~/Desktop/ and open to show user
  • Text skills: Extract .payload.nodes[].content for text output
  • Action skills: Confirm .payload.status for completion

Directory Structure

~/.refly/skills/
β”œβ”€β”€ base/                       # Base skill files (this symlink target)
β”‚   β”œβ”€β”€ SKILL.md
β”‚   └── rules/
β”‚       β”œβ”€β”€ execution.md
β”‚       β”œβ”€β”€ workflow.md
β”‚       β”œβ”€β”€ node.md
β”‚       β”œβ”€β”€ file.md
β”‚       └── skill.md
└── <skill-name>/               # Domain skill directories
    └── SKILL.md

~/.claude/skills/
β”œβ”€β”€ refly β†’ ~/.refly/skills/base/           # Base skill symlink
└── <skill-name> β†’ ~/.refly/skills/<name>/  # Domain skill symlinks

Routing

User intent -> match domain skill (name/trigger) in ~/.claude/skills/ -> read domain skill SKILL.md -> execute via refly skill run -> return CLI-verified result.

References

  • rules/execution.md - Skill execution patterns and error handling
  • rules/workflow.md - Workflow command reference
  • rules/node.md - Node command reference
  • rules/file.md - File command reference
  • rules/skill.md - Customized Skill command reference

Related skills