tool-execution
/tool-execution
Use for Freeflow programs, mutations, exact artifact recovery, and unfamiliar catalog operations; bounded direct read/search needs no skill solely for one call.
- Author
- hassan-mohiddin ↗
- Repository
- freeflow ↗
- Licence
- MIT
- Last repository change
- 28.10.2026
Assessment and security
- Files in this package
- 4
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 28.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use for Freeflow programs, mutations, exact artifact recovery, and unfamiliar catalog operations; bounded direct read/search needs no skill solely for one call.
Original author description
Use for Freeflow programs, mutations, exact artifact recovery, and unfamiliar catalog operations; bounded direct read/search needs no skill solely for one call.
How it works
- Choose The Surface
- Keep The Boundaries
SKILL.md preview
--- name: tool-execution description: "Use for Freeflow programs, mutations, exact artifact recovery, and unfamiliar catalog operations; bounded direct read/search needs no skill solely for one call." --- # Tool Execution Use Freeflow's bounded tools when they fit the work, without replacing native tools or gaining authority from a visible operation. The latest Runtime State and actual admission decide availability. This method applies to programs, mutations, exact recovery and unfamiliar catalog operations; a single bounded direct read or search can proceed from its own schema without loading this body. ## Choose The Surface One known focused read or search belongs in `freeflow_read` or `freeflow_search`. Batch known line ranges; use path discovery before contents, `count` before materializing hits, `matches` before `context`, and exact ranges only when the decision needs them. Limited coverage, skipped files, unavailable backends and missing continuations do not prove absence. Do not discover a direct operation already described by its tool schema. Use `freeflow_tools` search/describe for an unfamiliar operation or missing exact contract, then call its registered revision. Use `freeflow_run` when several next steps are already determined and bounded values can be filtered locally; one simple call does not need a program. Read [Programs and exact contracts](references/programs.md) before writing a program, and load the [generated core bindings](references/generated-program-bindings.md) for each core operation it declares. For a long-tail operation, use its complete `freeflow_tools.describe` binding; an unavailable binding is not a declaration. ## Keep The Boundaries Canonical child values stay in the restricted guest/host exchange; only explicit `emit` enters the program's outer model result. A model view may omit canonical data. Read [effects and recovery](references/effects-and-recovery.md) before applying a patch, recovering exact output, or handling a failed/unknown effect. A captured artifact describes bytes at its stated observation boundary, not today's external state. A program is not a transaction. Do not rerun a completed or unknown mutation merely because its model view, artifact or program failed. Stop for approval, changed instructions, an unresolved effect, or a semantic choice the program cannot make mechanically. Return the observed status, coverage and missing evidence rather than manufacture completion. Tool visibility, this skill, and stored artifacts never grant permission to act.
Files in this package (4)
- SKILL.md 2 KB
- references/effects-and-recovery.md 2 KB
- references/generated-program-bindings.md 21 KB
- references/programs.md 2 KB
Versions
The database has no other skills named tool-execution.
Database snapshot: 13.11.2026 · package version 49c92639ef48 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100setup-freeflow
Use when installing, activating or turning off Freeflow in a repository, changing or repairing its repository or personal configuration (.freeflow/config.json, .freeflow/local.json), or checking whether the current host is loading Freeflow's guidance and skills. - 100mode-contract
Use when choosing, changing, or explaining how Freeflow mode applies to current work.