Skip to content
Back to search

refly

SkillWorks with CodexGitHub

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/refly-ai-refly/badge.svg)](/listings/refly-ai-refly)

HTML

<a href="/listings/refly-ai-refly"><img src="/api/listings/refly-ai-refly/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Deploy Refly

- πŸ“˜ **[Self-Deployment Guide](https://docs.refly.ai/community-version/self-deploy/)** *(Recommended for Developers)* Step-by-step guide to deploying Refly on your own server using Docker.

- πŸ”Œ **[API Reference](https://github.com/refly-ai/refly/tree/main/docs/en/guide/api)** Complete API documentation for integrating Refly into your applications.

> [!TIP] > Want to explore instantly? Open the hosted workspace: <a href="https://refly.ai/workspace"><u>Refly Workspace</u></a>

What's Next?

After deployment, choose your path based on your use case:

| I want to... | Start here | Time | |-------------|-----------|------| | πŸ”§ **Build my first workflow** | [Create a Workflow](#create-your-first-workflow) | 5 mins | | πŸ”Œ **Call workflows via API** | [API Integration](#use-case-1-api-integration) | 10 mins | | πŸ’¬ **Connect to Lark/Feishu** | [Webhook Setup](#use-case-2-webhook-for-lark-feishu) | 15 mins | | πŸ€– **Export for Claude Code** | [Export Skills](#use-case-3-skills-for-claude-code) | 15 mins |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 387 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <img width="2880" height="1620" alt="the first open-source agent skills builder" src="https://github.com/user-attachments/assets/2609adbb-c8db-4ca4-8404-12eb32d19cf1" />
  2. # Refly β€” Agent Skills Builder Powered by Vibe Workflow
  3. <p align="right">
  4. <a href="README.md"><u>English</u></a> Β· <a href="README_CN.md"><u>δΈ­ζ–‡</u></a>
  5. </p>
  6. <p align="center">
  7. <a href="https://github.com/refly-ai/refly">
  8. <img src="https://img.shields.io/github/stars/refly-ai/refly?style=flat&colorA=080f12&colorB=1fa669&logo=github" alt="GitHub stars">
  9. </a>
  10. <a href="https://refly.ai/workspace">
  11. <img src="https://img.shields.io/badge/refly.ai-007bff?style=flat&colorA=080f12&colorB=007bff&logo=google-chrome&logoColor=white" alt="Website">
  12. </a>
  13. <a href="https://www.youtube.com/@refly-ai">
  14. <img src="https://img.shields.io/badge/YouTube-Refly%20AI-FF0000?style=flat&colorA=080f12&colorB=FF0000&logo=youtube&logoColor=white" alt="YouTube">
  15. </a>
  16. <a href="https://discord.com/invite/YVuYFjFvRC">
  17. <img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscord.com%2Fapi%2Finvites%2FYVuYFjFvRC%3Fwith_counts%3Dtrue&query=%24.approximate_member_count&suffix=%20members&logo=discord&logoColor=white&label=%20&color=7389D8&labelColor=6A7EC2" alt="Discord">
  18. </a>
  19. <a href="https://github.com/refly-ai/refly-skills">
  20. <img src="https://img.shields.io/badge/refly--skills-Repo-2ea043?style=flat&colorA=080f12&logo=github" alt="Refly Skills">
  21. </a><br>
  22. <a href="https://docs.refly.ai/">
  23. <img src="https://img.shields.io/badge/docs.refly.ai-Docs-2ea043?style=flat&colorA=080f12&logo=readthedocs" alt="Docs">
  24. </a>
  25. <a href="https://deepwiki.com/refly-ai/refly">
  26. <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
  27. </a>
  28. <a href="LICENSE">
  29. <img src="https://img.shields.io/badge/license-ReflyAI%20License-2ea043?style=flat&colorA=080f12" alt="License">
  30. </a>
  31. <a href="https://x.com/reflyai">
  32. <img src="https://img.shields.io/badge/%40reflyai-black?style=flat&logo=x&labelColor=%23101419&color=%232d2e30" alt="X (formerly Twitter) Follow">
  33. </a>
  34. </p>
  35. [APIs for Lovable](#use-case-1-api-integration) Β· [Webhooks for Lark/Feishu](#use-case-2-webhook-for-lark-feishu) Β· [Skills for Claude Code](#use-case-3-skills-for-claude-code) Β· [Build Clawdbot](#use-case-4-build-clawdbot)
  36. Skills are not prompts. They are durable infrastructure.
  37. Refly is the first open-source platform for building stable, atomic, and versioned agent skills.
  38. <a href="https://refly.ai/workspace"><u>Try it Now</u></a>
  39. ---
  40. ## Refly Skills
  41. Refly Skills is the official executable skill registry for Refly.
  42. - ⚑ **Run instantly**: Execute skills in Refly with one click
  43. - 🧩 **Reusable infrastructure**: Versioned skills, not one-off prompts
  44. - πŸ”Œ **Export anywhere**: Ship skills to Claude Code or deploy as APIs
  45. - 🌍 **Community-powered**: Import, fork, and publish your own skills
  46. Explore the registry: <a href="https://github.com/refly-ai/refly-skills"><u>Refly Skills Repo</u></a>
  47. Skills are deterministic agent capabilitiesβ€”reusable across workflows, teams, and runtimes.
  48. **TL;DR**: Refly compiles your enterprise SOPs into executable agent skills. Built in 3 minutes. Shipped anywhere.
  49. ---
  50. ## Quick Start
  51. ### Deploy Refly
  52. - πŸ“˜ **[Self-Deployment Guide](https://docs.refly.ai/community-version/self-deploy/)**
  53. *(Recommended for Developers)* Step-by-step guide to deploying Refly on your own server using Docker.
  54. - πŸ”Œ **[API Reference](https://github.com/refly-ai/refly/tree/main/docs/en/guide/api)**
  55. Complete API documentation for integrating Refly into your applications.
  56. > [!TIP]
  57. > Want to explore instantly? Open the hosted workspace: <a href="https://refly.ai/workspace"><u>Refly Workspace</u></a>
  58. ### What's Next?
  59. After deployment, choose your path based on your use case:
  60. | I want to... | Start here | Time |
  61. |-------------|-----------|------|
  62. | πŸ”§ **Build my first workflow** | [Create a Workflow](#create-your-first-workflow) | 5 mins |
  63. | πŸ”Œ **Call workflows via API** | [API Integration](#use-case-1-api-integration) | 10 mins |
  64. | πŸ’¬ **Connect to Lark/Feishu** | [Webhook Setup](#use-case-2-webhook-for-lark-feishu) | 15 mins |
  65. | πŸ€– **Export for Claude Code** | [Export Skills](#use-case-3-skills-for-claude-code) | 15 mins |
  66. | 🦞 **Build a Clawdbot** | [Build Clawdbot](#use-case-4-build-clawdbot) | 20 mins |
  67. ---
  68. ## Why Refly?
  69. Most AI Agents fail in production because they rely on "Vibe-coded" scripts and fragile, black-box logic. As the ecosystem moves toward agentic frameworks like Claude Code, AutoGen, and MCP, the bottleneck is no longer the LLMβ€”it's the lack of standardized, reliable actions.
  70. Refly bridges the gap between raw APIs and intelligent agents. We allow you to codify messy business logic into structured, version-controlled Agent skills that any agent can invoke with 100% reliability.
  71. **Stop hard-coding tools.** Build modular skills once in Refly's visual IDE and deploy them as MCP servers, standard APIs, or portable SDKs to any agent framework. <a href="https://refly.ai/workspace"><u>Try it Now</u></a>
  72. ---
  73. ## Core Capabilities
  74. ### 🎯 Construct with Vibe (Copilot-led Builder)
  75. Describe your business logic in natural language, and Refly's Model-Native DSL compiles your intent into a high-performance skill.
  76. - **Intent-Driven Construction**: Describe the work once; Refly turns intent into deterministic, reusable, and composable skills.
  77. - **Efficiency at Scale**: Streamlined DSL optimized for LLMs, ensuring fast execution and significantly lower token costs.
  78. - **3-Minute Deployment**: Transition from a static enterprise SOP to a production-ready agent skill in under 3 minutes.
  79. ### ⚑ Execute with Control (Intervenable Runtime)
  80. Break the "black box" of AI execution with a stateful runtime designed for deterministic reliability.
  81. - **Intervenable Runtime**: Pause, audit, and re-steer agent logic mid-run to ensure 100% operational compliance.
  82. - **Deterministic Guarantees**: Enforce strict business rules that minimize hallucinations and handle failure recovery.
  83. ### πŸš€ Ship to Production (Unified Agent Stack)
  84. Unify MCP integrations, tools, models, and reusable skills into a single execution layer.
  85. - **Universal Delivery**: Export as APIs for Lovable, webhooks for Slack or Lark/Feishu, or native tools for Claude Code and Cursor.
  86. - **Stable Scheduling**: Run workflows reliably on schedule with managed execution.
  87. ### πŸ›οΈ Govern as Assets (Skill Registry)
  88. Transform fragile scripts into governed, shared infrastructure across your organization.
  89. - **Central Skill Registry**: Securely manage, version, and share agent capabilities.
  90. - **Team Workspace Collaboration**: Build together with native version control and audit logs.
  91. ---
  92. ## Ecosystem
  93. Refly is designed to be the universal bridge between your existing enterprise toolchain and the next generation of agentic runtimes.
  94. ### Tooling & Protocols (Inputs)
  95. Bring your own data and logic into Refly with zero friction.
  96. - **3,000+ Native Tools**: Seamlessly integrate with Stripe, Slack, Salesforce, GitHub, etc.
  97. A full list of supported model and tools providers can be found in [provider-catalog.json](./config/provider-catalog.json).
  98. <img width="3840" height="1254" alt="part supported tools integrations in refly" src="https://github.com/user-attachments/assets/954f43bd-356d-48c4-a3b9-1c0f2e781a43" />
  99. - **MCP Support**: Full compatibility with Model Context Protocol servers
  100. - **Private Skill Connectors**: Connect to your databases, scripts, and internal systems
  101. ### Agent Runtimes & Platforms (Outputs)
  102. Export your deterministic skills to any environment where work happens.
  103. <img width="2688" height="1512" alt="deterministic skills can be exported to cursor, claude code and etc." src="https://github.com/user-attachments/assets/23e7a204-4dce-432f-b8bc-65839061d086" />
  104. - **AI Coding Tools**: Native export for Claude Code and Cursor (coming soon)
  105. - **App Builders**: Power Lovable or custom frontends via stateful APIs
  106. - **Automation Hubs**: Deploy as webhooks for Slack, Lark/Feishu, or Microsoft Teams
  107. - **Agent Frameworks**: Compatible with AutoGen, Manus, LangChain, and custom Python stacks
  108. ---
  109. ## Why Teams Choose Refly
  110. ### For Builders: From Vibe to Production
  111. Most agent tooling today falls into two categories:
  112. - Workflow builders (n8n, Dify): Great for orchestration, but workflows are fragile, trigger-only "black boxes," and hard to reuse.
  113. - Agent frameworks (LangChain): Powerful primitives, but require heavy engineering, manual boilerplate, and high maintenance to keep running.
  114. Refly eliminates the friction of manual configuration, giving you the fastest path from a "vibe" to a usable agent tool. By using our Streamlined DSL, you get the speed of a GUI with the precision of code.
  115. | Dimension | Legacy Automation <br><sub>(n8n, Dify)</sub> | Code-First SDKs <br><sub>(LangChain)</sub> | **Refly Skills** |
  116. | :--- | :--- | :--- | :--- |
  117. | **Interaction Depth** | Trigger-only <br><sub>Black box</sub> | Programmatic <br><sub>Code changes</sub> | **Intervenable runtime**<br><sub>Steer logic mid-run</sub> |
  118. | **Construction** | Manual API wiring & JSON | Manual Python/TS boilerplate | **Copilot-led**<br><sub>Describe intent β†’ skills generated</sub> |
  119. | **Recovery** | Fail = restart from scratch | Debug β†’ redeploy β†’ rerun | **Hot-fix**<br><sub>Repair workflows during execution</sub> |
  120. | **Portability** | Hard to reuse across environments | Framework-specific | **Export everywhere**<br><sub>To Claude Code, Cursor, Manus</sub> |
  121. | **Deployment** | Limited function tools | Custom microservices | **Production Ready**<br><sub>Stateful, validated APIs</sub> |
  122. ### For Enterprise: Scalable Skills Governance
  123. Workflow tools like n8n are great for basic connectivity, and frameworks like LangChain offer powerful primitives β€” but neither provides the governed, production-ready capability layer required for enterprise agent infrastructure.
  124. Refly acts as the Agent skills builder, providing the governance and reliability infrastructure required to deploy AI across the entire organization.
  125. | Enterprise Requirement | Legacy Tools <br><sub>(Workflow-first)</sub> | SDKs <br><sub>(Code-first)</sub> | **Refly (Skill OS)** |
  126. | :--- | :--- | :--- | :--- |
  127. | **Governance & Reuse** | Templates are copied and<br><sub>reconfigured per instance</sub> | No native registry<br><sub>for sharing logic</sub> | **Central skill registry**<br><sub>Versioned, shareable capability assets</sub> |
  128. | **Operational Reliability** | Trigger-based<br><sub>limited recovery</sub> | Custom handling required | **Stateful runtime**<br><sub>With validation + failure recovery</sub> |
  129. | **SOP Enforcement** | Workflows drift<br><sub>across copies</sub> | Depends on manual<br><sub>engineering discipline</sub> | **SOP-grade deterministic skills**<br><sub>With controlled execution</sub> |
  130. | **Deployment** | Instance-bound workflows | Code maintained manually<br><sub>per team</sub> | **Local-first, on-prem ready**<br><sub>Open-source infrastructure</sub> |
  131. | **Total Cost (TCO)** | Overhead grows with<br><sub>workflow complexity</sub> | High engineering<br><sub>maintenance costs</sub> | **Minimal DSL**<br><sub>Reduces token spend</sub> |
  132. ---
  133. ## Create Your First Workflow
  134. > [!NOTE]
  135. > This section assumes you have completed [self-deployment](https://docs.refly.ai/community-version/self-deploy/) and can access Refly at `http://localhost:5700`
  136. **Step 1: Register and Log In**
  137. 1. Open `http://localhost:5700` in your browser
  138. 2. Register with your email and password
  139. 3. Configure your first model provider:
  140. - Click the account icon (top right) β†’ Settings
  141. - Add a provider (e.g., OpenAI, Anthropic)
  142. - Add your first chat model
  143. - Set it as default
  144. > πŸ“– Detailed setup with screenshots: [Self-Deployment Guide](https://docs.refly.ai/community-version/self-deploy/#start-using-refly)
  145. **Step 2: Create a Workflow**
  146. 1. Click **"New Workflow"** on the home page
  147. 2. Choose a template or start from scratch:
  148. - **Blank Canvas**: Build with visual nodes
  149. - **Vibe Mode**: Describe your workflow in natural language
  150. **Example - Product Research Workflow**:
  151. ```text
  152. 1. Add "Web Search" node - searches for product information
  153. 2. Add "LLM" node - analyzes search results
  154. 3. Add "Output" node - formats the report
  155. 4. Connect the nodes
  156. 5. Click "Save"
  157. ```
  158. > [!TIP]
  159. > If you want the fastest path, start with Vibe Mode and iterate from a template.
  160. **Step 3: Test Your Workflow**
  161. 1. Click "Run" button
  162. 2. Enter test input (e.g., a product URL)
  163. 3. View execution results in real-time
  164. 4. Check logs if something fails
  165. ---
  166. ## Use Cases
  167. ### Use Case 1: API Integration
  168. **Goal**: Call your workflow from your application via REST API
  169. **Get Your API Credentials**
  170. 1. Go to Settings β†’ API Keys
  171. 2. Click "Generate New Key"
  172. 3. Copy your API key (keep it secure!)
  173. **Make Your First API Call**
  174. ```bash
  175. curl -X POST https://your-refly-instance.com/api/v1/workflows/{WORKFLOW_ID}/execute \
  176. -H "Authorization: Bearer YOUR_API_KEY" \
  177. -H "Content-Type: application/json" \
  178. -d '{
  179. "input": {
  180. "product_url": "https://example.com/product"
  181. }
  182. }'
  183. ```
  184. **Response**:
  185. ```json
  186. {
  187. "execution_id": "exec_abc123",
  188. "status": "running"
  189. }
  190. ```
  191. **Check Execution Status**
  192. ```bash
  193. curl https://your-refly-instance.com/api/v1/executions/{execution_id} \
  194. -H "Authorization: Bearer YOUR_API_KEY"
  195. ```
  196. πŸ“– **Full API Documentation**: [API Reference](https://github.com/refly-ai/refly/tree/main/docs/en/guide/api)
  197. ### Use Case 2: Webhook for Lark (Feishu)
  198. **Goal**: Trigger your workflow when someone sends a message in Lark
  199. **Prerequisites**
  200. - A Lark workspace with admin access
  201. - A workflow created in Refly
  202. **Setup Steps**
  203. 1. **In Refly**:
  204. - Open your workflow
  205. - Click "Settings" β†’ "Triggers"
  206. - Enable "Webhook Trigger"
  207. - Copy the Webhook URL
  208. 2. **In Lark/Feishu**:
  209. - Go to [api.feishu.com/apps](https://open.feishu.cn/app)
  210. - Create a "Custom App"
  211. - Navigate to "Event Subscriptions"
  212. - Paste the Refly Webhook URL into "Request URL"
  213. - Click "Add Event" and select "Receive Message"
  214. - Go to "Version Management" and publish the app
  215. 3. **Test**:
  216. - In Feishu, find your bot in the search bar and send a message (e.g., `analyze report.pdf`)
  217. - Your workflow executes and returns results via the webhook
  218. > ⚠️ **Note**: Detailed Lark/Feishu integration guide coming soon. For now, see [API Reference](https://github.com/refly-ai/refly/tree/main/docs/en/guide/api) for webhook configuration.
  219. ### Use Case 3: Skills for Claude Code
  220. **Goal**: Publish your Refly workflows as Claude Code skills
  221. **Quick Start**
  222. 1. **Install Refly CLI**
  223. ```bash
  224. npm install -g @powerformer/refly-cli
  225. ```
  226. 2. **Install a Skill**
  227. ```bash
  228. # Via Refly CLI
  229. refly skill install <skill-id>
  230. #Via npx
  231. npx skills add refly-ai/<skill-name>
  232. ```
  233. 3. **Publish a Skill**
  234. ```bash
  235. refly skill publish <skill-id>
  236. ```
  237. The skill is now available in Claude Code, Cursor, and MCP-powered workflows. Agent can invoke your workflow as a tool!
  238. πŸ“– **Documentation**: <a href="https://github.com/refly-ai/refly-skills"><u>Refly Skills</u></a>
  239. ### Use Case 4: Build Clawdbot
  240. πŸ“– **Tutorial**: <a href="https://powerformer.feishu.cn/wiki/Gz4swMzn0izknZki3g4coSgvnNe"><u>Build Clawdbot Tutorial</u></a>
  241. ***
  242. ## Community & Support
  243. - 🌟 **[Star us on GitHub](https://github.com/refly-ai/refly)**: It helps us keep building!
  244. - πŸ’¬ **[Discord](https://discord.com/invite/YVuYFjFvRC)**: Join our community
  245. - 🐦 **[Twitter](https://x.com/reflyai)**: Follow us for updates
  246. - πŸ“– **[Documentation](https://docs.refly.ai)**: Full guides and tutorials
  247. - πŸ› **[Issues](https://github.com/refly-ai/refly/issues)**: Report bugs or request features
  248. ---
  249. ## Join Us
  250. Join our community to get help, share your experience, and connect with other Refly users: <a href="https://docs.refly.ai/community/contact-us"><u>Refly Community</u></a>
  251. ---
  252. ## Contributing
  253. For those who'd like to contribute code, see our [Contribution Guide](CONTRIBUTING.md). At the same time, please consider supporting Refly by sharing it on social media and at events and conferences.
  254. > We are looking for contributors to help translate Refly into languages other than Mandarin or English. If you are interested in helping, please see the [Contribution Guide](CONTRIBUTING.md) for more information.
  255. ---
  256. ## Star History
  257. [![Star History Chart](https://api.star-history.com/svg?repos=refly-ai/refly&type=Date)](https://star-history.com/#refly-ai/refly&Date)
  258. ## License
  259. This repository is licensed under the [ReflyAI Open Source License](LICENSE), which is essentially the Apache 2.0 License with some additional restrictions.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.