AgentLink

July 8, 2026 · View on GitHub

A community skill pack for aeon that gives an agent a verified, human-backed on-chain identity on Base via AgentLink.

With the AgentLink skill an agent is linked to a biomapped human owner (proving a real, unique human stands behind it — without revealing who), appears in the on-chain BiomapperAgentRegistry, and can sign requests to free partner endpoints on Base mainnet.

Skills

SkillCategoryWhat it does
agentlinkcryptoChecks link status; if unlinked (or var=link) hands the human owner a linker URL to biomap + sign; once linked, documents how the agent signs requests and calls free XONA / WURK endpoints. Read-only, on-demand.

Install

bin/install-skill-pack techdigger/aeon-skill-pack-agentlink

This copies skills/agentlink/ into your aeon fork, adds a catalog row, and appends an entry to aeon.yml (disabled by default). Turn it on when ready:

# aeon.yml
agentlink: { enabled: true, schedule: "workflow_dispatch", var: "" }

Run it on demand from the dashboard, or with skill=agentlink (and var=link to force the linker hand-off).

Configure

The skill needs the agent to have a signing key, and a human owner to complete linking. Add these to your fork:

VariableWhereRequiredPurpose
AGENT_PRIVATE_KEYGitHub Actions secretyesThe agent's signing key. Without it the skill is a no-op.
AGENTLINK_OWNER_ADDRESSGitHub Actions secret (or var)only to linkThe human owner's biomapped Base wallet, used to generate the linker URL.

One-time sandbox wiring (required)

aeon's sandbox blocks secret-bearing outbound calls, so the calls that use AGENT_PRIVATE_KEY run in a pre-fetch script before the sandbox. This pack ships that script inside the skill dir; wire it once after installing:

  1. Copy the pre-fetch script to your repo-root scripts/: 
    cp skills/agentlink/prefetch-agentlink.sh scripts/prefetch-agentlink.sh
  2. Expose the two variables to the pre-fetch step. In .github/workflows/aeon.yml, under the Run pre-fetch scripts step's env: block, add: 
    AGENT_PRIVATE_KEY: ${{ secrets.AGENT_PRIVATE_KEY }}
AGENTLINK_OWNER_ADDRESS: ${{ secrets.AGENTLINK_OWNER_ADDRESS }}

The pre-fetch caches non-secret link state to .agentlink-cache/ (git-ignored by aeon's .*-cache/ rule); the read-only skill reads that cache and never handles the key itself.

Linking flow (one-time, human)

The agent can't biomap itself. When the skill runs unlinked it notifies you with a linker URL — open it, complete Biomapper, bridge to Base, and sign the link transaction in the AgentLink Linker. Re-run the skill; once status --json reports "linked": true, "active": true, the agent holds the skill.

Capabilities

read_only · external_api · sends_notifications — see aeon's CAPABILITIES.md. The skill never writes to the repo and never submits an on-chain transaction (the human owner signs the link); it reads link status and, when needed, surfaces a URL.

Learn more

License

MIT