skills

Installs the floo documentation skill for coding assistants such as Claude Code. Pass --path to write it, or --print to inspect the embedded content; one of the two is required.

floo skills install --path .claude/skills/floo

Flags

Flag	Description
`--path DIR`	Directory to write `SKILL.md` into (e.g., `.claude/skills/floo/`)
`--print`	Print skill content to stdout instead of writing a file

Examples

# Install the documentation entry point
floo skills install --path .claude/skills/floo

# Print skill content to stdout (for inspection or piping)
floo skills install --print

# Agent workflow: get skill metadata as JSON
floo skills install --print --json

# Print the skill to a custom file
floo skills install --print > my-custom-dir/SKILL.md

Installation creates the target directory when needed, writes one SKILL.md linking to the canonical docs, and prints recommended Claude Code permission settings for .claude/settings.json. The CLI tracks the installed path and refreshes it on floo update and floo version. Installation and refresh remove unchanged copies of the retired floo-services and floo-security skills inside that directory. Customized files, symlinks, and other files are preserved; remove those by hand. The plugin_skills JSON field is always an empty array, kept for existing consumers. For operating guidance, read Agent setup.

JSON output

{
  "success": true,
  "data": {
    "path": "/absolute/path/to/.claude/skills/floo/SKILL.md",
    "plugin_skills": [],
    "version": "2026.09.01.1",
    "recommended_permissions": {
      "read_only": [
        "Bash(floo apps list:*)",
        "Bash(floo apps show:*)",
        "Bash(floo logs:*)"
      ],
      "read_write": [
        "Bash(floo redeploy:*)",
        "Bash(floo env set:*)",
        "Bash(floo init:*)"
      ]
    }
  }
}

Errors

Code	Meaning
`MISSING_ARGUMENT`	Neither `--path` nor `--print` was given
`FILE_ERROR`	The target cannot be created, written, or cleaned up
`CONFIG_ERROR`	The skill was written but its path could not be saved for refresh

CLI

Config and runtime

Errors

API

Flags

Examples

JSON output

Errors

​Flags

​Examples

​JSON output

​Errors

Flags

Examples

JSON output

Errors