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
- 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 runclaudein any terminal to verify.One-time setupnpm i -g @anthropic-ai/claude-codeAlready have it? Skip ahead.
- 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 - Restart Claude Code.
Quit and reopen Claude Code (or any other agent that loads from
~/.claude/skills/). New skills are picked up on startup. - 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
- CLI only - Use
refly <command>, never call API directly. - Trust JSON - Only trust CLI JSON (
ok,payload,error,hint). - No fabricated IDs - Never invent workflow/run/node IDs.
- No tokens - Never print or request auth tokens.
- Stop on error - If
ok=false, stop and showhint.
Available Commands
| Command | ID Format | Description |
|---|---|---|
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-xxx | Run an installed skill, returns runId (we-xxx) |
refly workflow status <runId> --watch | we-xxx | Watch workflow execution status |
refly workflow detail <runId> | we-xxx | Get workflow run details |
refly workflow toolcalls <runId> --files --latest | we-xxx | Get files from latest toolcall |
refly file download <fileId> -o <path> | df-xxx | Download a file |
Tip: Get installationId (skpi-xxx) from refly skill installations.
Command Options
| Command | Option | Description |
|---|---|---|
workflow status | --watch | Poll until workflow completes |
workflow status | --interval <ms> | Polling interval in milliseconds (default: 5000) |
workflow toolcalls | --files | Return simplified output with only files and content |
workflow toolcalls | --latest | With --files, return only files from the most recent toolcall |
workflow toolcalls | --raw | Disable 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:
| Category | Skills | Output | Pattern |
|---|---|---|---|
| File Generation | image, video, audio skills | Files (png/mp4/mp3) | Run β Wait β Download β Open |
| Text/Data | search, research, report skills | Text content | Run β Wait β Extract content |
| Action | email, messaging, integration skills | Status confirmation | Run β 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 Format | Example | Used For |
|---|---|---|
skpi-xxx | skpi-h9kpmts9ho1kl9l1sohaloeu | skill run --id only |
we-xxx | we-abc123def456 | workflow status, workflow detail, workflow toolcalls |
c-xxx | c-g6emwcpi1wpalsz6j4gyi3d9 | Browser URL only |
df-xxx | df-b3yxyelshtwsbxbrkmcqxmx9 | file download |
skpe-xxx | skpe-qga5lpyv59yjzz2ghz2iv9bu | β οΈ Do NOT use for workflow commands |
Required behavior:
skill runreturnsRUN_ID(we-xxx) in.payload.workflowExecutions[0].id- Use
we-xxxfor all workflow commands (status,detail,toolcalls) - Choose execution pattern (A/B/C) based on skill category
- File skills: Download to
~/Desktop/andopento show user - Text skills: Extract
.payload.nodes[].contentfor text output - Action skills: Confirm
.payload.statusfor 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 handlingrules/workflow.md- Workflow command referencerules/node.md- Node command referencerules/file.md- File command referencerules/skill.md- Customized Skill command reference
Related skills
Spreadsheet & Excel Editor
anthropics
Open, edit, and create Excel and CSV files with formulas, formatting, and data cleaning.
n8n Architect
EtienneLescot
Create, edit, and validate n8n workflows and automation configurations.
Business Growth Toolkit
alirezarezvani
Manage customer health, predict churn, handle RFPs, and streamline sales operations.
Revenue Pipeline Analyzer
alirezarezvani
Analyze sales pipeline health, forecast accuracy, and go-to-market efficiency for SaaS teams.