flue

Build Flue AI-agent applications on Cloudflare Workers with Hono and the Agents SDK. Load when creating Flue agents, workflows, tools, skills, subagents, channels, routing, persistence, validation, deployment, observability, or tests. Entry point for all Flue sub-skills.

Jump to install

Repository: louisbrulenaudet/flue-skills
Last source activity: July 2, 2026 at 18:33
Detected SKILL.md language: English
Stars: 1
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/louisbrulenaudet/flue-skills --skill flue

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

27 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

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

Need a continuing, conversational instance that accepts messages over time?  → agents
Need a finite, one-shot agent-backed job (summarize, review, transform)?      → workflows
Need the model to call your code (DB lookup, API call, action)?               → tools
Need reusable instructions/process the agent loads on demand?                 → skills
Need a specialist the parent agent delegates to (no public endpoint)?         → subagents
Need to accept verified webhooks/events from an external provider?            → channels
Need to validate input/output shapes?                                         → validation-zod
Need durable business data (customers, tickets, payments)?                    → database
Shipping to Cloudflare Workers?                                               → deployment-cloudflare

// src/agents/hello.ts
import { createAgent } from '@flue/runtime';

export const description = 'Tells a short hello-world joke.';

export default createAgent(() => ({
  model: 'anthropic/claude-haiku-4-5',
  instructions: 'Tell a short "hello world" engineering joke.',
}));

pnpm flue dev                 # watch-mode local server
pnpm flue connect hello demo  # interactive session against instance "demo"

pnpm flue build --target <node|cloudflare>   # must build clean
# then exercise the affected route, e.g.:
curl "http://localhost:3583/workflows/<name>?wait=result" \
  -H 'Content-Type: application/json' -d '{ ... }'

flue

Install options

Review the source files

Flue

Flue

Sub-skills

Quick decision tree

Default implementation philosophy

Minimal working example

Verification is required before completion

Anti-patterns (do not do)

name	flue
description	Build Flue AI-agent applications on Cloudflare Workers with Hono and the Agents SDK. Load when creating Flue agents, workflows, tools, skills, subagents, channels, routing, persistence, validation, deployment, observability, or tests. Entry point for all Flue sub-skills.
type	core
library	flue
library_version	1.x (1.0 Beta line)
license	MIT

flue

Source facts

Install options

Review the source files

Flue

Flue

Sub-skills

Quick decision tree

Default implementation philosophy

Minimal working example

Verification is required before completion

Anti-patterns (do not do)