Motel Debug
kitlangton/motel
Debug applications with motel, a local OpenTelemetry ingest and query server.
A skill your agent uses when building, debugging, reviewing, or documenting Flue agents, workflows, channels, skills, tools, sandboxes, targets, routing, persistence, observability, or CLI usage…
Install Flue
$ npx skills add shadcn-labs/agentcn --skill flue -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install shadcn-labs/agentcn flue --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/shadcn-labs/agentcn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/flue .claude/skills/flue && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "flue" agent skill from https://github.com/shadcn-labs/agentcn/tree/main/.agents/skills/flue into .claude/skills/flue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flue", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/shadcn-labs/agentcn/tree/main/.agents/skills/flueType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add shadcn-labs/agentcn --skill flue -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install shadcn-labs/agentcn flue --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shadcn-labs/agentcn.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/flue .agents/skills/flue && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "flue" agent skill from https://github.com/shadcn-labs/agentcn/tree/main/.agents/skills/flue into .agents/skills/flue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flue", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add shadcn-labs/agentcn --skill flue -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install shadcn-labs/agentcn flue --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shadcn-labs/agentcn.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/flue .cursor/skills/flue && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "flue" agent skill from https://github.com/shadcn-labs/agentcn/tree/main/.agents/skills/flue into .cursor/skills/flue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flue", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/shadcn-labs/agentcn.git --path .agents/skills/flue--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add shadcn-labs/agentcn --skill flue -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install shadcn-labs/agentcn flue --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shadcn-labs/agentcn.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/flue .gemini/skills/flue && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "flue" agent skill from https://github.com/shadcn-labs/agentcn/tree/main/.agents/skills/flue into .gemini/skills/flue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flue", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install shadcn-labs/agentcn flueInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add shadcn-labs/agentcn --skill flue -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/shadcn-labs/agentcn.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/flue .github/skills/flue && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "flue" agent skill from https://github.com/shadcn-labs/agentcn/tree/main/.agents/skills/flue into .github/skills/flue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flue", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add shadcn-labs/agentcn --skill flue -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install shadcn-labs/agentcn flue --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shadcn-labs/agentcn.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/flue .opencode/skills/flue && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "flue" agent skill from https://github.com/shadcn-labs/agentcn/tree/main/.agents/skills/flue into .opencode/skills/flue/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flue", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
flue- GitHub stars
- 490
- Token cost
- ~2k tokens
- SKILL.md length
- 80 words
- Files
- 1
- Skills in repo
- 5
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses when building, debugging, reviewing, or documenting Flue agents, workflows, channels, skills, tools, sandboxes, targets, routing, persistence, observability, or CLI usage…
- Documenting Flue agents
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Routes coding agents to version-matched Flue documentation through the CLI
What it does
Flue is an agent skill from shadcn-labs/agentcn. Use when building, debugging, reviewing, or documenting Flue agents, workflows, channels, skills, tools, sandboxes, targets, routing, persistence, observability, or CLI usage; routes coding agents to version-matched Flue documentation through the CLI.
Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud, covering Observability. The repository describes itself as: shadcn/ui, but for building agents. 🤖. The licence is MIT.
When your agent uses it
- Documenting Flue agents
- Routes coding agents to version-matched Flue documentation through the CLI
Example prompts
- “/flue”
Requirements
- Node.js
- Docker
What it can do on your machine
Read from SKILL.md and the folder at commit 4cd4d83. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Flue loads about 2k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 80 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from shadcn-labs/agentcn at commit 4cd4d83, republished under its MIT licence (© shadcn-labs). 80 words, ~2,013 tokens.
Download SKILL.mdSave it as
.claude/skills/flue/SKILL.md (or your agent's skills folder).- name
- flue
- description
- Use when building, debugging, reviewing, or documenting Flue agents, workflows, channels, skills, tools, sandboxes, targets, routing, persistence, observability, or CLI usage; routes coding agents to version-matched Flue documentation through the CLI.
Flue
Use flue docs to read the documentation bundled with the installed @flue/cli version. Choose relevant paths from the catalog below and run flue docs read <path>. If no catalog entry matches your task, run flue docs search <query>, then read the most relevant result with flue docs read <path>.
For example, flue docs search "durable execution" searches with the query durable execution. If it returns the path concepts/durable-execution, run flue docs read concepts/durable-execution to read that page.
Documentation Catalog
<!-- flue-docs-catalog:start -->api/action-api -- Action API
Reference for defining reusable finite Actions with @flue/runtime.
api/agent-api -- Agent API
Reference for defining agents and running agent operations with @flue/runtime.
api/data-persistence-api -- Data Persistence API
Reference for Flue persistence adapters, stores, and session data.
api/errors-reference -- Errors Reference
Reference Flue transport errors, runtime failures, and development diagnostics.
api/events-reference -- Events Reference
Reference runtime activity, attached-agent event types, and global observation APIs.
api/provider-api -- Provider API
Register custom model providers and override built-in provider transport.
api/routing-api -- Routing API
Compose Flue routes in an authored application entrypoint.
api/sandbox-api -- Sandbox Adapter API
Adapt a provider sandbox SDK into Flue's public sandbox contract.
api/streaming-protocol -- Streaming Protocol
Reference for reading Flue agent and workflow event streams over Durable Streams.
api/workflow-api -- Workflow API
Reference for creating and invoking workflows with @flue/runtime.
cli/add -- flue add
Reference for discovering and applying Flue implementation blueprints.
cli/build -- flue build
Reference for creating deployable Flue application artifacts.
cli/connect -- flue connect
Reference for opening an interactive local agent-instance session from the command line.
cli/dev -- flue dev
Reference for starting a watch-mode local Flue development server.
cli/docs -- flue docs
Reference for listing, reading, and searching the bundled Flue documentation.
cli/init -- flue init
Reference for creating an initial Flue project configuration file.
cli/overview -- CLI
Use the Flue CLI to configure, develop, exercise, inspect, and build an application.
cli/run -- flue run
Reference for executing one workflow invocation from the command line.
cli/update -- flue update
Reference for updating integrations from newer Flue blueprint upgrade guides.
concepts/agents -- What is an agent?
What an AI agent actually is, why a model alone isn't one, and what makes a Flue agent different.
concepts/durable-execution -- Durable Agents
Understand how Flue agents and workflows handle server restarts, interrupted connections, and other disruptions.
ecosystem/channels/discord -- Discord
ecosystem/channels/github -- GitHub
ecosystem/channels/google-chat -- Google Chat
ecosystem/channels/intercom -- Intercom
ecosystem/channels/linear -- Linear
ecosystem/channels/messenger -- Facebook Messenger
ecosystem/channels/notion -- Notion
ecosystem/channels/resend -- Resend
ecosystem/channels/salesforce-marketing-cloud -- Salesforce Marketing Cloud
ecosystem/channels/shopify -- Shopify
ecosystem/channels/slack -- Slack
ecosystem/channels/stripe -- Stripe
ecosystem/channels/teams -- Microsoft Teams
ecosystem/channels/telegram -- Telegram
ecosystem/channels/twilio -- Twilio
ecosystem/channels/whatsapp -- WhatsApp
ecosystem/channels/zendesk -- Zendesk
ecosystem/databases/libsql -- libSQL
ecosystem/databases/mongodb -- MongoDB
ecosystem/databases/mysql -- MySQL
ecosystem/databases/postgres -- Postgres
ecosystem/databases/redis -- Redis
ecosystem/databases/supabase -- Supabase
ecosystem/databases/turso -- Turso
ecosystem/databases/valkey -- Valkey
ecosystem/deploy/aws -- Deploy Agents on AWS
ecosystem/deploy/cloudflare -- Deploy to Cloudflare
ecosystem/deploy/docker -- Deploy Agents with Docker
ecosystem/deploy/fly -- Deploy Agents on Fly.io
ecosystem/deploy/github-actions -- Build Agents for GitHub Actions
ecosystem/deploy/gitlab-ci -- Build Agents for GitLab CI/CD
ecosystem/deploy/node -- Deploy Agents on Node.js
ecosystem/deploy/railway -- Deploy Agents on Railway
ecosystem/deploy/render -- Deploy Agents on Render
ecosystem/deploy/sst -- Deploy Agents on SST
ecosystem/sandboxes/boxd -- boxd
ecosystem/sandboxes/cloudflare -- Cloudflare Sandbox
ecosystem/sandboxes/cloudflare-shell -- Cloudflare Shell
ecosystem/sandboxes/daytona -- Daytona
ecosystem/sandboxes/e2b -- E2B
ecosystem/sandboxes/exedev -- exe.dev
ecosystem/sandboxes/islo -- islo
ecosystem/sandboxes/mirage -- Mirage
ecosystem/sandboxes/modal -- Modal
ecosystem/sandboxes/vercel -- Vercel Sandbox
ecosystem/tooling/braintrust -- Braintrust
ecosystem/tooling/opentelemetry -- OpenTelemetry
ecosystem/tooling/sentry -- Sentry
ecosystem/tooling/vitest-evals -- Vitest Evals
getting-started/quickstart -- Getting Started
Set up a Flue project automatically or create your first agent manually.
guide/building-agents -- Agents
Create an agent, configure its capabilities, and send it messages over time.
guide/channels -- Channels
Receive verified provider events and connect them to Flue applications.
guide/database -- Database
Configure database-backed state for Flue agents and workflow runs.
guide/evals -- Evals
Evaluate Flue agents with repeatable Vitest suites using vitest-evals.
guide/models -- LLM (Models & Providers)
Select models, configure providers, and tune reasoning behavior in Flue agents.
guide/observability -- Observability
Inspect workflow runs, monitor agent activity, and export telemetry from your application.
guide/project-layout -- Project Layout
Understand the source files and generated output in a Flue project.
guide/react -- React
Build React interfaces for live agent conversations and workflow runs.
guide/routing -- Routing
Compose Flue with application routes, middleware, and custom HTTP ingress.
guide/sandboxes -- Sandboxes
Give agents a workspace for files and command-driven work.
guide/schedules -- Schedules
Invoke Flue workflows or dispatch agent input on a schedule with Cloudflare or Node.js.
guide/skills -- Skills
Add Agent Skills to Flue agents and invoke them from sessions.
guide/subagents -- Subagents
Let agents delegate focused work to named specialists.
guide/targets/cloudflare -- Cloudflare
Understand the Cloudflare-specific runtime behavior and APIs for Flue applications.
guide/targets/node -- Node.js
Understand the Node.js-specific runtime behavior and APIs for Flue applications.
guide/tools -- Tools
Give agents application capabilities through custom tools and MCP servers.
guide/workflows -- Workflows
Create finite agent-backed operations from inline or reusable Actions.
introduction/why-flue -- Why Flue?
Build autonomous AI agents and powerful workflows with a programmable TypeScript harness, and run them anywhere.
reference/configuration -- Configuration
Reference for flue.config.ts options.
sdk/agents -- client.agents
Invoke persistent agent instances and stream their events.
sdk/client -- createFlueClient(...)
Configure an SDK client for a deployed Flue application.
sdk/errors -- Errors
SDK HTTP and stream error types.
sdk/events -- Events and records
SDK event, workflow-run record, and normalized model-turn types.
sdk/overview -- SDK overview
Reference for consuming deployed Flue agents and workflows with @flue/sdk.
sdk/runs -- client.runs
Inspect and stream HTTP-exposed workflow runs.
sdk/workflows -- client.workflows
Start workflow runs and receive their run ID.<!-- flue-docs-catalog:end -->© shadcn-labs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/flue of shadcn-labs/agentcn.
Open the folder on GitHubat commit 4cd4d83
Compare with similar skills
Flue next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Flue this skillshadcn-labs/agentcn | 490 | — | ~2k | Automated safety check: Pass | MIT | |
| Motel Debugkitlangton/motel | 298 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Logging Observabilitygetsentry/toolkit | 920 | — | ~2.6k | Automated safety check: Pass | Custom licence | |
| Rift Backend EffectCompound-inc/rift | 124 | — | ~1.8k | Automated safety check: Pass | Custom licence | |
| Crash Instrumentationnexus-labs-automation/mobile-observability | 116 | — | ~744 | Automated safety check: Pass | MIT | |
| Ad ArchitectureCorridorTech/PoseCap | 224 | — | ~1.5k | Automated safety check: Notes | Apache-2.0 |
Similar skills
- Official
Logging Observability
getsentry/toolkit
Review code for correct logging and error handling patterns.
Rift Backend Effect
Compound-inc/rift
A skill your agent uses when adding, reviewing, or refactoring backend code in Rift's TanStack Start app that should follow apps/start/BACKENDEFFECTPLAYBOOK.md.
Crash Instrumentation
nexus-labs-automation/mobile-observability
Set up crash instrumentation with actionable context. An agent skill from nexus-labs-automation/mobile-observability.
Ad Architecture
CorridorTech/PoseCap
Generate ARCHITECTURE.md at the repo root by scanning the code first, pre-filling layers/patterns/observability/deployment from observed signals, then asking only the genuine gaps.
Codex Session Debugging
weave-os/router
Correlates a Codex CLI session's local transcript with a model router's production logs to explain why a reply rendered the way it did.
More from shadcn-labs/agentcn
Mastra File Agents
shadcn-labs/agentcn
Migrate Mastra code-based agents (agents built with new Agent(...) and registered in a Mastra({ agents }) map) to the file-based convention: one directory per agent under src/mastra/agents.
SEO Audit
shadcn-labs/agentcn
How to present the deterministic AI-SEO audit returned by auditpage.
Research
shadcn-labs/agentcn
Iterative, self-evaluating web research. An agent skill from shadcn-labs/agentcn.
Workspace
shadcn-labs/agentcn
How to safely operate the sandboxed workspace. An agent skill from shadcn-labs/agentcn.
Related
Categories
Questions about Flue
What does Flue do?
A skill your agent uses when building, debugging, reviewing, or documenting Flue agents, workflows, channels, skills, tools, sandboxes, targets, routing, persistence, observability, or CLI usage…. Flue is an agent skill from shadcn-labs/agentcn. Use when building, debugging, reviewing, or documenting Flue agents, workflows, channels, skills, tools, sandboxes, targets, routing, persistence, observability, or CLI usage; routes coding agents to version-matched Flue documentation through the CLI.
When should I use Flue?
Flue fits situations like: documenting Flue agents; routes coding agents to version-matched Flue documentation through the CLI.
How do I install Flue in Claude Code?
Run `npx skills add shadcn-labs/agentcn --skill flue -a claude-code`. Or copy the skill folder (.agents/skills/flue in shadcn-labs/agentcn) into .claude/skills/flue in your project. Claude Code loads it when a task matches its description.
How do I install Flue in Codex?
Run `npx skills add shadcn-labs/agentcn --skill flue -a codex`. Or copy the skill folder (.agents/skills/flue in shadcn-labs/agentcn) into .agents/skills/flue in your project. Codex loads it when a task matches its description.
Can I use Flue in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shadcn-labs/agentcn --skill flue -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flue, .gemini/skills/flue, .github/skills/flue and .opencode/skills/flue in your project.
What does Flue need to run?
SKILL.md names no scripts, command-line tools or credentials: Flue is instructions for the agent only. Our summary lists: Node.js; Docker.
Does Flue access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Flue safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Flue use?
Flue is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Flue use?
About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Flue?
Skills that share tags, products or a category with Flue: Motel Debug (kitlangton/motel, 298 stars), Logging Observability (getsentry/toolkit, 920 stars), Rift Backend Effect (Compound-inc/rift, 124 stars) and Crash Instrumentation (nexus-labs-automation/mobile-observability, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Flue?
shadcn-labs (a GitHub organization) maintains it in shadcn-labs/agentcn, which has 490 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.
Source: shadcn-labs/agentcn on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.