Skip to content

FloLess-PL/floless-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

floless-skills

FloLess is a visual workflow automation platform for AEC engineering. These skills teach AI terminals how to drive the FloLess CLI to build, modify, compile, and run workflows from any Claude Code, Codex CLI, or OpenCode session.

Install

Marketplace install (recommended)

/plugin marketplace add FloLess-PL/floless-skills
/plugin install floless@floless-skills

Manual install

AI Terminal Command
Claude Code git clone https://github.com/FloLess-PL/floless-skills ~/.claude/skills/floless-skills
Codex CLI git clone https://github.com/FloLess-PL/floless-skills ~/.codex/skills/floless-skills
OpenCode git clone https://github.com/FloLess-PL/floless-skills ~/.opencode/skills/floless-skills

For Claude Code and Codex CLI, individual skill directories under skills/ are symlinked or copied into the terminal's skills folder. For OpenCode, clone the full repository into its skills directory.

Skills in this plugin

Skill Description
floless-canvas Design readable FloLess workflow canvas layouts. Use when positioning nodes, understanding port index semantics, or debugging unreadable node arrangements. Teaches top-to-bottom flow, 200px vertical stepping with 300px horizontal offset for parallel branches, and the X/Y coordinate system for Trigger/Action/SmartNode/ThinkNode/Condition/Display node types.
floless-cli Connect to and drive the FloLess CLI from any AI terminal. Use when connecting to the FloLess desktop app, parsing the response envelope, handling CLI errors, recovering from port-file failures, or understanding exit codes. Covers port-file discovery at %LocalAppData%/FloLess/cli-api.port, the Stripe-style envelope shape, desktop lifecycle (floless start / floless close), and the full reference for all 27 shipping commands. Windows only.
floless-overview Learn what FloLess is, its node taxonomy, and how to build your first workflow from an AI terminal. Use when first encountering FloLess from Claude Code, Codex CLI, or OpenCode — or when deciding which specialty floless-* skill to load next. Covers node types (Trigger, Action, Smart Node, Think Node, Condition, Display), provider landscape (Excel, File, Tekla, Trimble Connect, HTTP, Email, Teams), Flow A vs Flow B architecture, and an end-to-end first-workflow walkthrough.
floless-smart-nodes Write FloLess Smart Nodes — compiled C# code for deterministic, zero-cost-per-execution workflow logic. Use when writing or fixing Smart Node code, running the compile-fix loop, choosing target frameworks (net8.0 vs net48 for Tekla), pinning software versions (tekla-2025), or iterating on compilation diagnostics. Covers the full diagnostic sequence — workflow nodes → node-context → compile → nodeUpdated.
floless-think-nodes Configure FloLess Think Nodes — LLM-per-execution nodes for prompts, classification, summarization, extraction, and translation. Use when authoring or updating Think Node configuration, writing prompt templates, selecting models and temperature, managing I/O schemas, or using the update-think-node PATCH semantics. Also covers the Smart vs Think decision rule — prefer Smart Nodes (deterministic C#) when logic is static.
floless-triggers Discover and configure FloLess trigger nodes. Use when picking a trigger for a workflow, setting trigger fields, referencing trigger output in downstream nodes, or understanding provider-specific trigger behavior. Covers 45+ trigger types grouped by provider — Excel (cell change), File (folder watcher), Schedule (cron/interval), Email (IMAP), Tekla (drawing events, model events, selection events, clash events), and Trimble Connect (BCF topics). Run floless triggers --json to list all triggers or floless triggers --json --provider <name> to filter by provider.
floless-update-skills Update FloLess skills to the latest GitHub release. Use when the user wants to upgrade their installed floless-skills, check for new versions, or sync after a FloLess CLI release. Detects marketplace plugin vs git-clone vs direct skill-copy install layouts across Claude Code, Codex CLI, and OpenCode runtimes; compares the local plugin.json version to GitHub; shows the changelog between versions; and runs the right update path (plugin update, git pull, or recopy).
floless-workflows Build and modify FloLess workflows (.flo files) from any AI terminal. Use when creating a workflow from scratch (Flow A), augmenting a workflow loaded in the desktop (Flow B), running or stopping a workflow headlessly, validating workflow JSON, or passing variables between nodes with {{trigger.cellValue}}/{{action1.result}} templating. Covers all 17 workflow subcommands — create, validate, info, list, nodes, node-context, add-node, delete-node, connect, disconnect, update-think-node, export, open, save, save-as, run, stop.

Prerequisites

  • FloLess desktop app installed and running
  • floless CLI available on your system PATH
  • Windows 10 or Windows 11

Troubleshooting

Run the health-check script to diagnose common issues:

bash scripts/health-check.sh

The script (authored in plan 02) verifies the FloLess desktop is running, the CLI is on PATH, and the port file is discoverable.

Contributing

See CONTRIBUTING.md for guidelines on authoring new skills, running local validation, and submitting pull requests. The CONTRIBUTING.md file is authored in plan 02.

License

MIT — see LICENSE-skills for the full text.

About

Claude Skills for driving the FloLess CLI from AI terminals

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages