skills.rest
Agent-Field
Agent-FieldOFFICIAL
Explore all skills by this author →
Website𝕏@agentfield_aiGitHub

agentfield-use

Discovers and dispatches tasks to installed AgentField agents via the control plane.

2.5k|411|Updated Nov 5, 2025
Search Tags:#CLI#control plane#run monitoring#async dispatch#Agent orchestration#agentfield#task offload
One-click install
npx skills add https://github.com/Agent-Field/agentfield --skill agentfield-use
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentfield-use
Source: https://github.com/Agent-Field/agentfield/tree/main/skills/agentfield-use
Command: npx skills add https://github.com/Agent-Field/agentfield --skill agentfield-use

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When working on tasks, you may have specialized AgentField agents installed on your machine that could handle the work, but discovering them, learning their input contracts, dispatching jobs, and monitoring runs requires knowing the right CLI commands and API endpoints. This Skill provides the complete operational playbook for offloading work to installed AgentField subharnesses instead of doing everything inline.

Core Features & Use Cases

  • Runtime Discovery: Find which agents and reasoners are installed and running using af ls -e, af agent search, and the discovery capabilities API, with health-status checks to avoid dispatching to dead nodes.
  • Contract-First Dispatch: Fetch exact input schemas with af call <node>.<reasoner> --schema before calling, dispatch asynchronously, and monitor runs via af wait, af tail, or batch-status polling.
  • Failure Handling & Reporting: Diagnose missing API keys, wedged runs, and silent failures with a structured troubleshooting table, then report results with duration, cost windows, and live run URLs.
  • Use Case: You need to review ten pull requests. The Skill checks the fleet, finds the pr-af agent, dispatches all ten reviews concurrently, polls them as a group, and reports each result with its run URL.

Quick Start

Ask the assistant to check which AgentField agents are installed and offload the current task to a covering subharness.

Frequently Asked Questions about agentfield-use

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find which AgentField agents are installed and running?▼

Run `af ls -e` to list entry-point reasoners on running agents, or `af list` to see all installed agents with their status. Discovery only shows running agents, so an installed-but-stopped node appears in `af list` but not in discovery until started with `af run <name>`.

How do I call an AgentField reasoner with the correct input?▼

Fetch the exact contract first with `af call <node>.<reasoner> --schema`, then dispatch with `af call <node>.<reasoner> --in '{...}' --async`. The CLI validates your payload client-side against the schema before anything is queued.

Why does my AgentField call return agent not found?▼

This HTTP 400 error means the node never registered, usually because it is installed but not started. Run `af list` to confirm installation, then `af run <name>` to start it; the start attempt also reveals missing required API keys.

What does af wait exit code 2 mean?▼

Exit code 2 means timeout, not failure — the run is still going on the control plane. Wait again with a longer `--timeout` value or switch to `af tail` or group polling; exit code 1 is the genuine failure signal.

Can I dispatch multiple AgentField runs concurrently?▼

Yes, async dispatch is designed for concurrency — fire independent calls up front and poll them as a group. Check `meta.load` in responses for `recommended_max_concurrent`, and keep roughly 3-4 heavy runs per node unless the agent documents otherwise.

When should I not offload work to an AgentField agent?▼

Do not offload when no installed healthy agent's reasoner description and input schema cover the job, when the user explicitly asks you to do it inline, or when `AGENTFIELD_HARNESS_DEPTH` is set indicating you are already inside a harness session.

Related Skills

Explore More Software Engineering Skills→
jbreel77888jbreel77888

dotenvx-secrets

Encrypt API secrets with AES and manage isolated environment keypairs.

Community
Advanced
DNYoussefDNYoussef
4

stream-chain

Chain sequential agent outputs into multi-step workflow pipelines.

Community
Intermediate
cosmicstack-labscosmicstack-labs
364

agent-health-monitoring

Monitor agent vital signs and detect anomalies in production AI fleets.

Official
Advanced
runbear-iorunbear-io
11

delegate-task

Delegate tasks between agents through an asynchronous inbox queue.

Official
Advanced