agentleFS
EskyeeEskyee/agentbot-opensource/skills/yoink/SKILL.md

yoink

Skill17 starsChanged 5 months agoMITView on GitHub

Play Yoink, an onchain capture-the-flag game on Base. Yoink the flag from the current holder, check game stats and leaderboards, view player scores, and compete for the trophy. Uses Bankr for transaction execution.

  • Sends data out

3 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 2 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Yoink the flag: - Call yoink() to take the flag from the current holder

    line 15
  2. Distinctive:

    Use Bankr's arbitrary transaction feature:

    line 46
  3. Distinctive:

    Ensure cooldown elapsed (600s) and you're not current holder

    line 69
  4. Very specific:

    Verify with lastYoinkedBy() or score(address)

    line 71

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Yoink

Play Yoink, an onchain capture-the-flag game on Base. Yoink the flag from the current holder to start your clock. The player with the most total yoinks holds the trophy.

Contract: 0x4bBFD120d9f352A0BEd7a014bd67913a2007a878 on Base (chain ID 8453)

Game Rules

  1. Yoink the flag - Call yoink() to take the flag from the current holder
  2. Cooldown - You must wait 10 minutes (600 seconds) between yoinks
  3. No self-yoink - You cannot yoink from yourself
  4. Accumulate time - While you hold the flag, your time score increases
  5. Compete for trophy - The player with the most total yoinks holds the trophy (token ID 2)
  6. Track yoinks - Your total yoink count is tracked separately from time

Contract Interface

RPC template:

curl -s -X POST https://mainnet.base.org -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"0x4bBFD120d9f352A0BEd7a014bd67913a2007a878","data":"SELECTOR+PARAMS"},"latest"],"id":1}' | jq -r '.result'
FunctionSelectorParamsReturns
yoink()0x9846cd9e-(write)
lastYoinkedBy()0xd4dbf9f4-address
lastYoinkedAt()0x6a99616f-uint256 timestamp
totalYoinks()0xa5d0dadd-uint256
topYoinker()0x6a974e6e-address (trophy holder)
mostYoinks()0xd2d7774a-uint256 (record)
COOLDOWN()0xa2724a4d-uint256 (600)
score(address)0x776f3843addr (32B padded)(yoinks, time, lastYoinkedAt)
balanceOf(address,uint256)0x00fdd58eaddr + tokenIduint256 (FLAG_ID=1, TROPHY_ID=2)

Encoding: Addresses are zero-padded to 32 bytes. score() returns 96 bytes (3 × uint256).

Yoinking

Use Bankr's arbitrary transaction feature:

{
  "to": "0x4bBFD120d9f352A0BEd7a014bd67913a2007a878",
  "data": "0x9846cd9e",
  "value": "0",
  "chainId": 8453
}

Errors

ErrorSelectorMeaning
SlowDown(uint256)0x58d6f4c6Cooldown not elapsed. Param = seconds remaining.
Unauthorized()0x82b42900You already hold the flag.

Cooldown check: current_time - lastYoinkedAt() >= 600

Workflow

  • Query lastYoinkedBy() and lastYoinkedAt() to check status/cooldown
  • Ensure cooldown elapsed (600s) and you're not current holder
  • Submit yoink transaction via Bankr
  • Verify with lastYoinkedBy() or score(address)

Resources

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.