---
slug: "flue-skills"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/louisbrulenaudet/flue-skills@main/README.md"
repo: "https://github.com/louisbrulenaudet/flue-skills"
source_file: "README.md"
branch: "main"
---
# Flue Skills

Agent Skills pack for building [Flue](https://flueframework.com) AI-agent applications on Cloudflare Workers (Hono + Agents SDK). Available as a plugin for Claude Code, Cursor, and OpenAI Codex.

Load when creating Flue agents, workflows, tools, skills, subagents, channels, routing, persistence, validation, deployment, observability, or tests.

## Install

```bash
npx skills add louisbrulenaudet/flue-skills
```

Then select the skills you wish to install.

New to Flue? Start with the official walkthrough: [flueframework.com/start.md](https://flueframework.com/start.md)

## Available Skill

| Skill | Description |
|---|---|
| [`flue`](https://github.com/louisbrulenaudet/flue-skills/tree/HEAD/skills/flue) | Entry point for all Flue sub-skills — routes to 16 reference guides and 8 workflow recipes |

See [`skills/flue/README.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/README.md) for how agents should use the pack.

## What's inside `skills/flue/`

- **`SKILL.md`** — entrypoint, decision tree, critical rules, and verification gates
- **`reference/`** — one focused file per Flue domain (agents, workflows, tools, channels, deployment, etc.)
- **`workflows/`** — step-by-step recipes with inputs, outputs, success criteria, and verification steps
- **`checks/eval-cases.md`** — representative tasks to validate the pack before relying on it

### Sub-skills (reference topics)

| Topic | File |
|---|---|
| Project layout, `src/` vs `.flue/`, naming | [`reference/project-layout.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/project-layout.md) |
| HTTP surface, middleware, mounting `flue()` | [`reference/routing.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/routing.md) |
| Hono + Workers entrypoint, assets, request flow | [`reference/hono-workers.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/hono-workers.md) |
| `createAgent`, profiles, sessions, HTTP exposure | [`reference/agents.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/agents.md) |
| `run()`, `FlueContext`, sessions, result schemas | [`reference/workflows.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/workflows.md) |
| `defineTool`, parameters, safe interfaces | [`reference/tools.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/tools.md) |
| Flue skills (`SKILL.md`, `with { type: 'skill' }`) | [`reference/skills.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/skills.md) |
| Subagent profiles, delegation boundaries | [`reference/subagents.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/subagents.md) |
| Verified provider ingress, dispatch, idempotency | [`reference/channels.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/channels.md) |
| Zod validation, type inference, schema slots | [`reference/validation-zod.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/validation-zod.md) |
| Flue persistence + your own business database | [`reference/database.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/database.md) |
| `flue build`, wrangler, migrations, secrets, deploy | [`reference/deployment-cloudflare.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/deployment-cloudflare.md) |
| `ctx.log`, `observe()`, OTel/Braintrust/Sentry | [`reference/observability.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/observability.md) |
| vitest-evals, local dev, pre-deploy checks | [`reference/testing.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/testing.md) |
| Auth boundaries, secrets, prompt injection, isolation | [`reference/security.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/security.md) |
| End-to-end copy-pasteable examples | [`reference/examples.md`](https://github.com/louisbrulenaudet/flue-skills/blob/HEAD/skills/flue/reference/examples.md) |

## Plugins

This repo serves as a plugin for multiple platforms:

- **Claude Code** — [`.claude-plugin/`](https://github.com/louisbrulenaudet/flue-skills/tree/HEAD/.claude-plugin/)
- **Cursor** — [`.cursor-plugin/`](https://github.com/louisbrulenaudet/flue-skills/tree/HEAD/.cursor-plugin/)
- **OpenAI Codex** — [`.codex-plugin/`](https://github.com/louisbrulenaudet/flue-skills/tree/HEAD/.codex-plugin/)

## Editing skills

All content is authored in [`skills/flue/`](https://github.com/louisbrulenaudet/flue-skills/tree/HEAD/skills/flue/). Edit directly in this repo.

Before changing API guidance, confirm against the installed Flue version via `pnpm flue docs` or [flueframework.com/docs](https://flueframework.com/docs).

## Prerequisites

- Node.js 20+
- A Flue project with the `pnpm flue` CLI
- Cloudflare account (optional — for Workers deployment; Flue also runs on Node.js)
- Confirm APIs via `pnpm flue docs` or [flueframework.com/docs](https://flueframework.com/docs)

## Links

- [Flue — The Open Agent Framework](https://flueframework.com)
- [Getting started walkthrough](https://flueframework.com/start.md)
- [Documentation](https://flueframework.com/docs)