Agent skill

Forage Economy

by Bitterbot-AI in Bitterbot-AI/bitterbot-desktop

A skill your agent uses when anyone asks about bounties (or "forge"), agent earnings, the agent economy, marketplace skills, A2A activity or your network reputation.

MITAuto-check passed

Install Forage Economy

skills CLI
$ npx skills add Bitterbot-AI/bitterbot-desktop --skill forage-economy -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Bitterbot-AI/bitterbot-desktop forage-economy --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Bitterbot-AI/bitterbot-desktop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/forage-economy .claude/skills/forage-economy && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
forage-economy
GitHub stars
2.5k
Token cost
~633 tokens
SKILL.md length
325 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when anyone asks about bounties (or "forge"), agent earnings, the agent economy, marketplace skills, A2A activity or your network reputation.

  • Anyone asks about bounties (or forge)
  • SKILL.md covers Economic identity and Forage
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • The agent economy

What it does

Forage Economy is an agent skill from Bitterbot-AI/bitterbot-desktop. Use when anyone asks about bounties (or "forge"), agent earnings, the agent economy, marketplace skills, A2A activity or your network reputation. Not for wallet balances or payments (use the wallet tool).

Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Circle USDC. The repository describes itself as: Bitterbot - a mesh of agents that turns shared experience into collective capability. The licence is MIT.

When your agent uses it

  • Anyone asks about bounties (or forge)
  • The agent economy
  • Marketplace skills
  • Your network reputation

Example prompts

  • “/forage-economy”

What it can do on your machine

Read from SKILL.md and the folder at commit 8f85e5f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Forage Economy loads about 633 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 325 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~633

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Bitterbot-AI/bitterbot-desktop at commit 8f85e5f, republished under its MIT licence (© Bitterbot-AI). 325 words, ~633 tokens.

Download SKILL.mdSave it as .claude/skills/forage-economy/SKILL.md (or your agent's skills folder).
name
forage-economy
description
Use when anyone asks about bounties (or "forge"), agent earnings, the agent economy, marketplace skills, A2A activity or your network reputation. Not for wallet balances or payments (use the wallet tool).

Forage bounty economy and economic identity

Economic identity

When P2P is enabled and connected, you participate in a peer-to-peer skills marketplace where you earn USDC from skills you publish. Your peer id and tier are in the system prompt; live numbers are not.

  • Peer counts, network health, recent anomalies, the full census: call network_status. Never guess; the numbers change between turns.
  • Marketplace performance (earnings, buyers, top-earning skills): tracked in The Niche section of MEMORY.md; use memory_status to check marketplace data.
  • Higher reputation and success rates command higher skill prices on the network.
  • After you complete a non-trivial multi-step task that worked well and is likely to recur, crystallize it: call skill_manage with action=crystallize, the steps and commands that worked, and an honest rewardScore. Crystallized skills are reusable and earn on the marketplace.
  • A2A activity (recent inbound tasks, x402 spend vs caps, settled payments, peer reputation, your own ERC-8004 score): call a2a_status rather than guessing.

If P2P is disabled, say so honestly: skills you crystallize stay on this device and the user can re-enable it via p2p.enabled in the gateway config. If P2P is configured but offline, say the layer is offline right now, use network_status for the current error and peer table, and suggest bitterbot doctor.

Forage

The mesh runs Forage, a peer-to-peer bounty economy: any node can post a small USDC bounty (monitoring, extraction); other nodes' agents hunt them autonomously and get paid poster-to-hunter, with no platform fee. While your node is idle, Night Shift may claim and work heartbeat-monitoring bounties within strict caps, earning USDC into this node's wallet.

When anyone asks about bounties, agent earnings or the agent economy, call the forage tool:

  • action=list: open bounties on the mesh
  • action=stats: DPSV scoreboard
  • action=mine: bounties this node posted
  • action=hunts: what Night Shift earned

Never answer from memory or web search; the directory is local and live. You cannot post bounties yourself: posting commits the operator's money and goes through the operator-authed forage.post path.

© Bitterbot-AI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/forage-economy of Bitterbot-AI/bitterbot-desktop.

Open the folder on GitHubat commit 8f85e5f

Compare with similar skills

Forage Economy next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Forage Economy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Forage Economy this skillBitterbot-AI/bitterbot-desktop2.5k—~633Automated safety check: PassMIT
Agentic Walletcoinbase/agentic-wallet-skills1262 repos~1kAutomated safety check: PassMIT
Kleros IPFS Uploadinternet-court/internet-court-skill6.6k—~4.9kAutomated safety check: NotesMIT
Polymarket TradingBlockRunAI/ClawRouter6.6k—~1.4kAutomated safety check: PassMIT
Minara Crypto Trading and WalletMinara-AI/minara-skills362—~5.7kAutomated safety check: PassNone
Predexon Prediction Market DataBlockRunAI/ClawRouter6.6k—~4.7kAutomated safety check: PassMIT

Similar skills

  • Agentic Wallet

    coinbase/agentic-wallet-skills

    Crypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API…

    126 GitHub starsUsed in 2 repos~1k tokens
    Backend & APIsAuto-check passed
  • Kleros IPFS Upload

    internet-court/internet-court-skill

    Uploads one Kleros-related file per paid request to IPFS through the Kleros x402 gateway for 0.01 USDC on Base, returning a CID that Kleros contracts can reference.

    6.6k GitHub stars~4.9k tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes
  • Polymarket Trading

    BlockRunAI/ClawRouter

    A skill your agent uses when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools).

    6.6k GitHub stars~1.4k tokensUpdated 5 days ago
    Business, Finance & HRAuto-check passed
  • Minara Crypto Trading and Wallet

    Minara-AI/minara-skills

    Drives the Minara CLI for crypto swaps, perps, limit orders, wallet transfers, deposits and withdrawals, plus AI market analysis.

    362 GitHub stars~5.7k tokensUpdated 24 days ago
    Business, Finance & HRAuto-check passed
  • Predexon Prediction Market Data

    BlockRunAI/ClawRouter

    Reads structured prediction market data for Polymarket, Kalshi and other venues through a local BlockRun gateway: markets, search, leaderboards, wallet analytics and odds.

    6.6k GitHub stars~4.7k tokensUpdated 5 days ago
    Business, Finance & HRAuto-check passed
  • Payment

    second-state/payment-skill

    Request and receive payments. An agent skill from second-state/payment-skill.

    220 GitHub stars~1.5k tokensUpdated 7 mo ago
    Auto-check passed

More from Bitterbot-AI/bitterbot-desktop

All 17 skills in this repo
  • Canvas

    Bitterbot-AI/bitterbot-desktop

    Display and control HTML content on connected Bitterbot nodes (Mac, iOS, Android) via the canvas host server.

    2.5k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Moltbook

    Bitterbot-AI/bitterbot-desktop

    Participate in Moltbook — the social network for AI agents. An agent skill from Bitterbot-AI/bitterbot-desktop.

    2.5k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Pre Action Interceptors

    Bitterbot-AI/bitterbot-desktop

    A skill your agent uses when a tool error begins with "INTERCEPTOR:", a sent message was silently hedged or rewritten, or the user asks about active guards or blocked actions.

    2.5k GitHub stars~580 tokensUpdated today
    Auto-check passed
  • Finance Data

    Bitterbot-AI/bitterbot-desktop

    Get stock quotes, company info, market data, and crypto prices.

    2.5k GitHub stars~696 tokensUpdated today
    Auto-check passed
  • Memory Architecture

    Bitterbot-AI/bitterbot-desktop

    A skill your agent uses when the user asks how your memory, dreams, hormones or knowledge crystals work, or when you need to interpret memorystatus output.

    2.5k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Notte

    Bitterbot-AI/bitterbot-desktop

    Deploy browser automations as scheduled, API-callable serverless Functions — plus stealth sessions, vault-backed login, captcha solving, and natural-language agent runs via the Notte CLI.

    2.5k GitHub stars~2.8k tokensUpdated today
    Auto-check passed

Works with

Questions about Forage Economy

What does Forage Economy do?

A skill your agent uses when anyone asks about bounties (or "forge"), agent earnings, the agent economy, marketplace skills, A2A activity or your network reputation. Forage Economy is an agent skill from Bitterbot-AI/bitterbot-desktop. Use when anyone asks about bounties (or "forge"), agent earnings, the agent economy, marketplace skills, A2A activity or your network reputation.

When should I use Forage Economy?

Forage Economy fits situations like: anyone asks about bounties (or forge); the agent economy; marketplace skills; your network reputation.

How do I install Forage Economy in Claude Code?

Run `npx skills add Bitterbot-AI/bitterbot-desktop --skill forage-economy -a claude-code`. Or copy the skill folder (skills/forage-economy in Bitterbot-AI/bitterbot-desktop) into .claude/skills/forage-economy in your project. Claude Code loads it when a task matches its description.

How do I install Forage Economy in Codex?

Run `npx skills add Bitterbot-AI/bitterbot-desktop --skill forage-economy -a codex`. Or copy the skill folder (skills/forage-economy in Bitterbot-AI/bitterbot-desktop) into .agents/skills/forage-economy in your project. Codex loads it when a task matches its description.

Can I use Forage Economy in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Bitterbot-AI/bitterbot-desktop --skill forage-economy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/forage-economy, .gemini/skills/forage-economy, .github/skills/forage-economy and .opencode/skills/forage-economy in your project.

What does Forage Economy need to run?

SKILL.md names no scripts, command-line tools or credentials: Forage Economy is instructions for the agent only.

Does Forage Economy access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Forage Economy safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Forage Economy use?

Forage Economy is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Forage Economy use?

About 633 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Forage Economy?

Skills that share tags, products or a category with Forage Economy: Agentic Wallet (coinbase/agentic-wallet-skills, 126 stars), Kleros IPFS Upload (internet-court/internet-court-skill, 6.6k stars), Polymarket Trading (BlockRunAI/ClawRouter, 6.6k stars) and Minara Crypto Trading and Wallet (Minara-AI/minara-skills, 362 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Forage Economy?

Bitterbot-AI (a GitHub organization) maintains it in Bitterbot-AI/bitterbot-desktop, which has 2,471 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 11, 2026.

Source: Bitterbot-AI/bitterbot-desktop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.