Agent Engineering HandbookGitHub

Idea 05 of 19 The nineteen ideas

Build small tool adapters for things the CLI cannot do (video/asset uploads to PRs)

On this page

Theo built a tool for agent uploads

Theo describes agents being unable to attach videos through the command-line tools used for pull requests. The interface allowed drag-and-drop uploads, so he built a file-upload skill backed by a small Cloudflare service. He says his machines could upload files through that service and place the resulting links in pull requests.

Confirm existing tools cannot upload before building

First confirm that the required operation is missing from the tools currently available to the agent. Reuse an authorized transport before building a narrow adapter, and document that adapter's contract as a skill. Verify that the actual agent can use it, and obtain applicable authorization before posting any resulting link.

Build upload tools only for recurring gaps

A small adapter fits recurring tasks where people can attach media by hand but agents lack that operation. Look for that gap in recurring screenshot, video attachment, or signed artifact tasks handled by people. If an authorized tool already provides the operation, reuse it rather than treating the gap as established.

Upload instructions do not prove successful uploads

The inspected on-screen file names FILE_HOST_TOKEN and uses curl --fail-with-body over HTTP PUT. It specifies a public URL from the response body, but that does not prove an upload succeeded. The inspection establishes neither additional endpoint details nor a broader security model for the service. An equivalent needs its own key-handling review, and this example grants no authority to deploy a service. The adapter pattern still fits a verified capability gap when its transport and use are authorized.

Watch at 05:52 · Home · Agent Engineering Handbook, September 9, 2026