flowcraft-config

flowcraft-config is a skill for Codex from GizClaw/flowcraft. It costs 96 tokens per session (1,604 once invoked), scanned A, original, MIT.

A configuration tool for FlowCraft, a system for deploying software agents. It creates and checks the files that define agents, resources, runtime behavior, and how graph nodes connect.

In plain words
What is it for?
Use it to write, review, validate, and troubleshoot FlowCraft deployment files, including model access, workspaces, sandboxes, memory, tools, sessions, and graph wiring.
Why use it?
It reduces mistakes when assembling a complete deployment configuration and identifies structural errors with a validator.

Skill for Codex

Written for Codex: agents/openai.yaml present.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/gizclaw/flowcraft/flowcraft-config
Any agent
npx skills add GizClaw/flowcraft --skill flowcraft-config
Clone the repo
git clone --depth 1 https://github.com/GizClaw/flowcraft

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for flowcraft-config

README.md
[![agentmods](https://agentmods.dev/badge/skills/gizclaw/flowcraft/flowcraft-config.svg)](https://agentmods.dev/skills/gizclaw/flowcraft/flowcraft-config)
Your own site
<a href="https://agentmods.dev/skills/gizclaw/flowcraft/flowcraft-config"><img src="https://agentmods.dev/badge/skills/gizclaw/flowcraft/flowcraft-config.svg" alt="Measured on agentmods" height="20"></a>
Per session 96 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,604 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00096 $0.01604
Opus 5 $0.00048 $0.00802
Sonnet 5 $0.00019 $0.00321
Haiku 4.5 $0.00010 $0.00160

Measured 2d ago against content hash bbab33133e7a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

flowcraft-config scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/validate-config.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/flowcraft-config/SKILL.md · 128 lines

How it starts

The opening of the file, as written. The whole thing — 128 lines — stays where its author put it; the contents beside it link to each section on GitHub.

FlowCraft Config Authoring

Write complete FlowCraft deployment configuration: deploy.yaml, the runtime section, resource sub-documents, and graph JSON. Validate with the L2 structural validator and fix errors against the reference cards.

Workflow

  1. Scope the deployment. Collect the agents, capabilities (chat, tools, memory, scripts, sandboxing), and runtime needs (sessions, resume, event bus, checkpoint stores).
  2. Draft the deployment document. deploy.yaml is the convention but any filename works; pass whatever path you choose to the validator. Read references/deploy.md first. Order the areas: resources → agents → runtime. Decide whole-resource vs item dep refs (infer vs ws/project).
  3. Write sub-documents. Read references/resources.md for the owning module's schema. Workspace before sandbox (custom sandbox runners may depend on workspace resources). Memory implementation modules are app-registered — omit implementation examples; core/memory contracts and hooks are fine to use.
  4. Write graph JSON. Read references/graph.md. Prefer routing: wire the inference.Router into the graph engine and omit model in inference nodes; pin model only when no router is wired. Model refs must use the nested id form; script nodes need runtime and source; wire edges back to the inference node after tool nodes.
  5. Validate structurally with L2. Run skills/flowcraft-config/scripts/validate-config.sh <deployment-file> (or the installed copy's script). The validator pins the FlowCraft core module in its go.mod and works standalone from any directory. It is structural only: it strictly decodes the document through core/deploy.Parse (unknown fields are rejected, resource/agent entries are shape-checked), strictly decodes and validates the runtime subtree through core/runtime.DecodeConfig when present, and structurally validates graph definitions through core/graph.GraphDefinition.Validate. It does not build resources: no factory registry, no settings file/embed resolution, no node config decoding, no credentials, and no provider calls. Custom and app-registered kinds pass as long as they fit the resource envelope; their settings semantics are the host build's job.

Read the full file on GitHub · 128 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago Changed bbab33133e7a
  2. 6d ago First seen · 128 lines · 96 tokens per session scan A 6635f5b378d3

Subscribe to this mod's changes

flowcraft-config is a skill published in the GitHub repository GizClaw/flowcraft (415 stars, last pushed yesterday), licensed MIT. It adds 96 tokens to every session and 1,604 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.