Supported agents
Which AI agents can use the Flowershow skill, how to install it in each (one file, no Node.js needed), and what each agent can do.
The Flowershow skill works with any agent that supports Agent Skills: a folder with a SKILL.md file that the agent loads when it's relevant. The skill is a single file, so installing it just means putting SKILL.md where your agent looks for skills. No Node.js or npm is needed.
The quickest way is to ask your agent: "Install the Flowershow skill from https://raw.githubusercontent.com/flowershow/skills/main/SKILL.md into your skills folder."
To publish, the agent also needs to run the fl CLI, which means it needs a terminal and network access. Agents without a terminal can still use the skill to write config.json, custom.css and content for you to publish.
At a glance
| Agent | Install the skill | Can run fl and publish? |
|---|---|---|
| Claude Code | Copy SKILL.md to ~/.claude/skills/flowershow/ | Yes (tested) |
| Codex (CLI, IDE, app) | Copy SKILL.md to ~/.agents/skills/flowershow/ | Yes, if network access is allowed |
| Cursor | Copy SKILL.md to ~/.cursor/skills/flowershow/ | Yes, from the agent's terminal |
| Claude apps (claude.ai, desktop, mobile) | Upload a zip in the skills settings | Use the Flowershow connector to publish; running fl depends on code execution and network access (see below) |
| ChatGPT | Add the skill in ChatGPT's skills settings | Use the Flowershow connector to publish; ChatGPT's sandbox can't reach the internet to run fl |
| Other skills-compatible agents | Copy SKILL.md to the agent's skills folder | If the agent has a terminal and network |
Install
The skill is one file. Download it into your agent's skills folder.
Claude Code
mkdir -p ~/.claude/skills/flowershow
curl -fsSL https://raw.githubusercontent.com/flowershow/skills/main/SKILL.md -o ~/.claude/skills/flowershow/SKILL.md
Restart Claude Code, then ask: "Publish this folder with Flowershow."
Codex
Codex reads user skills from ~/.agents/skills:
mkdir -p ~/.agents/skills/flowershow
curl -fsSL https://raw.githubusercontent.com/flowershow/skills/main/SKILL.md -o ~/.agents/skills/flowershow/SKILL.md
Codex runs commands in a sandbox that may block network access by default. When it asks to run fl with network access, approve it (or start Codex with a mode that allows network).
Cursor
mkdir -p ~/.cursor/skills/flowershow
curl -fsSL https://raw.githubusercontent.com/flowershow/skills/main/SKILL.md -o ~/.cursor/skills/flowershow/SKILL.md
Cursor's agent runs fl in its integrated terminal. Approve the commands when asked.
Claude apps (claude.ai, Claude desktop, Claude mobile)
- Download
SKILL.md, put it in a folder namedflowershow, and zip the folder (flowershow.zipcontainingflowershow/SKILL.md). - In Claude, open Settings → Capabilities, make sure code execution is on, and upload the zip under Skills.
- Start a chat and ask Claude to publish something.
To publish from the Claude apps, Claude has to install fl in its sandbox and reach flowershow.app, so the sandbox needs network access to those domains. You log in each session by opening the link fl login prints. If network access isn't available, Claude can still prepare the files (or a zip) and the config for you to publish with fl on your own machine or by drag and drop.
ChatGPT
ChatGPT supports skills. Add the Flowershow skill from the same SKILL.md in ChatGPT's skills settings, then ask ChatGPT to publish. As with the Claude apps, publishing directly needs its sandbox to allow network access to github.com (to download fl) and flowershow.app; otherwise ChatGPT can prepare the files for you to publish yourself.
Any other agent
If your agent doesn't support skills, add the contents of SKILL.md to its custom instructions, or tell it: "Read https://raw.githubusercontent.com/flowershow/skills/main/SKILL.md and follow it."
Optional: install for all local agents with Node.js
If you already have Node.js, the skills tool installs the skill for every agent it detects on your machine:
npx skills add flowershow/skills --global
To skip the prompts and pick agents explicitly:
npx skills add flowershow/skills --global -y -a claude-code -a codex -a cursor
Update later with npx skills update.
Cloud and headless agents
Agents that run in a cloud sandbox or without a browser can't easily complete fl login. Two options:
- Publish under your account: create a personal access token at cloud.flowershow.app/tokens and give it to the agent as
FLOWERSHOW_TOKEN. See Environment token. - Publish without an account: the agent runs
fl --anon <folder>and gives you the claim link it prints. The site lives for 7 days unless you claim it. See Publish without an account.
Install the CLI
The skill tells the agent how to install fl if it's missing. You can also install it yourself first, which avoids sudo prompts inside the agent:
curl -fsSL https://raw.githubusercontent.com/flowershow/flowershow/main/apps/cli/install.sh | sh
fl login
See the CLI reference for Windows and manual installs. The CLI is the Go binary fl; the old npm packages flowershow and @flowershow/publish are deprecated, so don't let an agent install them.
What the agent can do
With the skill and fl, your agent can:
- Publish a Markdown file, a folder, an HTML page, or a folder of HTML with its CSS, JavaScript and data (see Publishing HTML)
- Convert a docx, pptx, pdf and similar documents to Markdown and publish them
- Update a site by re-running the same command, list your sites, and delete one
- Configure the site with
config.jsonandcustom.css - Walk you through steps it can't do itself (custom domain DNS, comments, password protection, billing) in the dashboard
The agent reads the Flowershow docs as Markdown (see Markdown access), starting from the index at /docs/sitemap.md.