bankr-job-workflow_skill

Overview

This skill implements Bankr's asynchronous submit-poll-complete job pattern for executing multi-chain DeFi operations via the Bankr MCP tools. It provides the core flow to submit natural-language prompts, poll job status, handle progress updates, and surface final responses and transactions. Use it to reliably manage long-running Bankr API tasks and recover from transient errors.

How this skill works

You submit a natural-language request with bankr_agent_submit_prompt and receive a jobId. The skill polls bankr_agent_get_job_status at a 2-second interval, reporting only new statusUpdates and watching for terminal states. When status becomes completed it returns the response text and any executed transactions; on failed or cancelled it surfaces the error and recommended next steps. It can also cancel jobs via bankr_agent_cancel_job and resume polling after transient failures.

When to use it

• Executing Bankr operations that may take seconds to minutes (trades, swaps, multi-step flows).
• Submitting natural-language trading or balance requests to Bankr (e.g., buy/sell, check holdings).
• Retrieving progressive execution logs or transactions for audit and UX feedback.
• Handling operations where server-side processing is asynchronous and status must be tracked.
• Implementing retry and recovery logic when polling fails or times out.

Best practices

• Poll every 2 seconds and avoid spamming; track last reported update to only emit NEW statusUpdates.
• Apply a soft timeout: suggest cancellation or escalation after ~3 minutes for simple queries, but allow longer for complex workflows.
• When status is completed, return both the human-readable response and the transactions array for reconciliation.
• On failure, read the error field and provide actionable suggestions (retry, simplify request, or cancel).
• If a poll request fails, retry after a brief delay; the job continues server-side and can be resumed with the same jobId.

Example use cases

• Buy $50 of ETH on Base: submit prompt, poll for transaction details, confirm executed trade and tx hashes.
• Price query: submit "What is ETH price?", poll until completed, and state price clearly (e.g., "ETH is $3,245.67").
• Balance check: request holdings summary, poll, and present assets with USD values.
• Market analysis: submit research prompt, stream statusUpdates like "Analyzing market data...", then summarize insights when completed.
• Long-running multi-step DeFi flow: submit high-level instruction, monitor progress updates, and collect final transactions for on-chain verification.