SKILL.md
Tệp skill vẫn nằm trong kho mã của nhà phát hành.
Dán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add refly-ai/refly --skill references -a cursor -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add refly-ai/refly --skill references -a claude-code -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add refly-ai/refly --skill references -a codex -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add refly-ai/refly --skill references -a grok -yGửi tin nhắn đã sao chép trong cuộc trò chuyện Grok Bot. Bot sẽ lấy tệp SKILL.md này từ GitHub và thêm vào bộ skill mà mọi Bot của bạn dùng chung.
Install this skill: https://github.com/refly-ai/refly/tree/HEAD/packages/cli/skill/referencesTừ nhà phát hành
# List skill packages
refly skill list [options]
--status <status> # Filter: draft, published, deprecated
--mine # Show only my packages
--tags <tags> # Filter by tags (comma-separated)
--page <number> # Page number (default: 1)
--page-size <number> # Page size (default: 20)
# Search public packages
refly skill search <query> [options]
--tags <tags> # Filter by tags (comma-separated)
--page <number> # Page number (default: 1)
--page-size <number> # Page size (default: 20)
# Get skill details
refly skill get <skillId> [options]
--include-workflows # Include workflow details
--share-id <shareId> # Share ID for private skills
# Create skill package (see "Skill Creation Modes" below)
refly skill create [options]
--name <name> # Skill name (required)
--version <version> # Semantic version (default: 1.0.0)
--description <desc> # Skill description
--triggers <triggers> # Trigger phrases (comma-separated)
--tags <tags> # Category tags (comma-separated)
--workflow <workflowId> # Bind single workflow
--workflow-ids <ids> # Bind multiple workflows (comma-separated)
--workflow-spec <json> # Workflow spec JSON
--workflow-query <query> # Natural language description
--verbose # Include workflow details in output
# Publishing
refly skill publish <skillId> # Make public
refly skill unpublish <skillId> # Make private
refly skill delete <skillId> [options]
--force # Skip confirmation
# Local management
refly skill sync [options] # Sync registry with filesystem
--dry-run # Preview changes only
--prune # Remove orphan entries
refly skill validate [path] [options]
--fix # Attempt to fix issues
# Install skill
refly skill install <skillId> [options]
--version <version> # Specific version
--share-id <shareId> # Share ID for private skills
--config <json> # Installation config JSON
# List installations
refly skill installations [options]
--status <status> # Filter: downloading, initializing, ready, error, disabled
--page <number> # Page number (default: 1)
--page-size <number> # Page size (default: 20)
# Uninstall
refly skill uninstall <installationId> [options]
--force # Skip confirmation
# Run installed skill
refly skill run <installationId> [options]
--input <json> # Input JSON for the skill
--workflow <skillWorkflowId> # Run specific workflow only
--async # Run asynchronously
refly skill create --name <name> --workflow-query "<query>"
Behavior:
Optional metadata (does not generate workflow by itself):
--description, --triggers, --tagsExample:
refly skill create \
--name comfyui-refly-skill \
--workflow-query "ComfyUI image generation workflow collection" \
--description "ComfyUI image workflow collection" \
--triggers "comfyui,text to image,image generation,image to image" \
--tags "image,comfyui"
refly skill create --name <name> --workflow <workflowId>
Bind multiple workflows:
refly skill create --name <name> --workflow-ids "<workflowId1,workflowId2>"
Example:
refly skill create \
--name my-skill \
--description "My custom skill" \
--workflow c-zybbx65ydi5npo7xevjx1wlr \
--triggers "custom,workflow" \
--tags "internal"
refly skill create --name <name> --workflow-ids "<workflowId1,workflowId2>"
Example:
refly skill create \
--name multi-workflow-skill \
--description "Multiple workflow entry points" \
--workflow-ids "c-aaa111,c-bbb222" \
--triggers "multi,entry" \
--tags "batch,workflow"
refly skill create --name <name> --workflow-spec '<json>'
Example:
refly skill create \
--name pdf-processor \
--workflow-spec '{
"nodes": [
{"id": "n1", "type": "start", "data": {"title": "Start"}},
{"id": "n2", "type": "skillResponse", "data": {"title": "Process PDF", "metadata": {"query": "Extract and summarize PDF content"}}}
],
"edges": [
{"id": "e1", "source": "n1", "target": "n2"}
]
}'
Note: Examples use
startandskillResponse. Additional node types may be supported by backend.
Use when you only want a local skill directory and registry entry.
# Create local skill files manually, then sync
refly skill sync
You can later create a cloud skill package with:
refly skill create --name <name> --workflow <workflowId>
When no --workflow, --workflow-ids, --workflow-spec, or --workflow-query is specified,
CLI will return skill.create.needs_workflow with suggested options and examples.
~/.refly/skills/
├── base/ # Base skill files (symlink target for 'refly')
│ ├── SKILL.md
│ └── rules/
│ ├── 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
~/.claude/skills/refly → ~/.refly/skills/base/~/.claude/skills/<name> → ~/.refly/skills/<name>/Claude Code discovers skills via symlinks in ~/.claude/skills/. Each skill is a symlink pointing to the actual skill directory in ~/.refly/skills/.
Location: ~/.refly/skills/<skill-name>/SKILL.md (accessed via ~/.claude/skills/<skill-name>/SKILL.md)
---
name: <skill-name>
description: <one-line summary, under 100 chars>
workflowId: <workflow-id>
triggers:
- <phrase-1>
- <phrase-2>
tags:
- <tag-1>
author: <author>
version: 1.0.0
---
# <Skill Name>
## Quick Start
<Minimal code example>
## Run
```bash
refly skill run <installationId> --input '<json>'
```
## Advanced
**Feature A**: See [FEATURE_A.md](FEATURE_A.md)
**API Reference**: See [REFERENCE.md](REFERENCE.md)
Naming: lowercase, hyphens, max 64 chars (pdf-processing, doc-translator)
Description: verb + what + when, third person, under 100 chars
Triggers: 3-6 high-signal phrases, mix EN/ZH if needed
Structure: Each skill is a directory with skill.md as entry; push details to sibling files
Workflow Creation:
refly skill install -> refly skill run)--workflow-spec for complex scenarios requiring precise controlIntegration flow:
refly skill create (generates workflow + local symlink)refly skill publish -> makes skill discoverablerefly skill install -> creates local SKILL.md + symlinkrefly skill run <installationId>{
"ok": true,
"type": "skill.list",
"version": "1.0",
"payload": {
"skills": [
{
"skillId": "skp-xxx",
"name": "my-skill",
"version": "1.0.0",
"description": "Skill description",
"status": "published",
"isPublic": true,
"downloadCount": 10,
"createdAt": "2026-01-19T00:00:00Z"
}
],
"total": 10,
"page": 1,
"pageSize": 20,
"hasMore": false
}
}
{
"ok": true,
"type": "skill.installations",
"version": "1.0",
"payload": {
"installations": [
{
"installationId": "skpi-xxx",
"skillId": "skp-xxx",
"skillName": "my-skill",
"skillVersion": "1.0.0",
"status": "ready",
"installedAt": "2026-01-19T00:00:00Z"
}
],
"total": 3,
"page": 1,
"pageSize": 20,
"hasMore": false
}
}
{
"ok": true,
"type": "skill.run",
"version": "1.0",
"payload": {
"executionId": "skpe-xxx",
"installationId": "skpi-xxx",
"status": "completed",
"workflowExecutions": [
{
"skillWorkflowId": "skw-xxx",
"workflowId": "c-xxx",
"status": "completed"
}
],
"result": {},
"error": null
}
}
refly skill sync will:
~/.claude/skills/--fix: recreate broken symlinks--prune: remove broken symlinksrefly skill validate [path] will:
Example output:
{
"ok": true,
"type": "skill.validate",
"version": "1.0",
"payload": {
"path": "/path/to/skills",
"summary": {
"total": 3,
"valid": 2,
"invalid": 1,
"warnings": 1
}
}
}
Note: Invalid JSON in
--workflow-specwill fail the command; ensure it is valid JSON.
The first open-source agent skills builder. Define skills by vibe workflow, run on Claude Code, Cursor, Codex & more. Build Clawdbot 🦞· APIs for Lovable · Bots for Slack & Lark/Feishu · Skills are in
---name: reflydescription: The first open-source agent skills builder. Define skills by vibe workflow, run on Claude Code, Cursor, Codex…---# packages/cli/skill/references/skill.mdTổng quan
The first open-source agent skills builder. Define skills by vibe workflow, run on Claude Code, Cursor, Codex & more. Build Clawdbot 🦞· APIs for Lovable · Bots for Slack & Lark/Feishu · Skills are infrastructure, not prompts.
Câu hỏi thường gặp
Tải packages/cli/skill/references/skill.md từ nhà phát hành, hoặc sao chép đường dẫn và mở kho mã. PlugMCP chỉ liệt kê skill và không lưu trữ tệp này.
Nhà phát hành duy trì nó tại https://github.com/refly-ai/refly.
Claude, Cursor, Codex và Grok Build có thể đọc tệp SKILL.md mà bạn thêm từ kho mã của nhà phát hành. Grok Bot cài đặt skill khi bạn gửi liên kết thư mục GitHub của skill trong cuộc trò chuyện.