Skip to content
Skills Library
AI & agents · Tool integration

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.

Repository
freeflow ↗
Licence
MIT
Last repository change
28.10.2026

Assessment and security

85/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content20 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 28.10.2026, without references to retired models or APIs.

Licence

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

  1. Choose The Surface
  2. Keep The Boundaries
Original SKILL.md headings · 17 lines, 326 words
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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.