Agent skill

Chainlink Oracle Guide

by nirholas in nirholas/three.ws

How Chainlink oracle price feeds work — architecture, reading feeds on-chain, available pairs, the aggregator model, and oracle security.

MITAuto-check passedBusiness, Finance & HR

Install Chainlink Oracle Guide

skills CLI
$ npx skills add nirholas/three.ws --skill chainlink-oracle-guide -a claude-code

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

GitHub CLI
$ gh skill install nirholas/three.ws chainlink-oracle-guide --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/nirholas/three.ws.git skills-src && mkdir -p .claude/skills && cp -r skills-src/data/skills/protocol/chainlink-oracle-guide .claude/skills/chainlink-oracle-guide && 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
chainlink-oracle-guide
GitHub stars
226
Token cost
~1.9k tokens
SKILL.md length
574 words
Files
1
Skills in repo
165
Repo updated
First seen
Licence
MIT

At a glance

How Chainlink oracle price feeds work — architecture, reading feeds on-chain, available pairs, the aggregator model, and oracle security.

  • Works in 5 steps: Data sources: Multiple professional data… → Independent observation: Each node… → On-chain submission: Nodes submit… → …
  • Explaining oracles
  • SKILL.md covers What Problem Do Oracles Solve?, How Chainlink Works, Reading Price Feeds and Key Price Feed Addresses, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Chainlink Oracle Guide is an agent skill from nirholas/three.ws. How Chainlink oracle price feeds work — architecture, reading feeds on-chain, available pairs, the aggregator model, and oracle security. Covers how DeFi protocols (Aave, Sperax, Compound) rely on Chainlink for accurate pricing. Use when explaining oracles, price feeds, or DeFi infrastructure.

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

It sits in Business, Finance & HR, covering Crypto and DeFi analysis and Smart contracts. The repository describes itself as: Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web… The licence is MIT.

When your agent uses it

  • Explaining oracles
  • DeFi infrastructure

Example prompts

  • “/chainlink-oracle-guide”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Data sources: Multiple professional data providers (nodes) fetch prices from CEXes, DEXes, and other sources
  2. Independent observation: Each node independently computes a price
  3. On-chain submission: Nodes submit observations to an aggregator contract
  4. Median calculation: The contract takes the median of all reports
  5. Storage: The median price is stored as the latest answer

What it can do on your machine

Read from SKILL.md and the folder at commit 238ef60. 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 (its code samples are solidity and javascript).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • data.chain.link
    • docs.chain.link
    • github.com
    • pyth.network
    • docs.chat.sperax.io

    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

Chainlink Oracle Guide loads about 1.9k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 574 words of instructions outside code blocks.

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

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 nirholas/three.ws at commit 238ef60, republished under its MIT licence (© nirholas). 574 words, ~1,925 tokens.

Download SKILL.mdSave it as .claude/skills/chainlink-oracle-guide/SKILL.md (or your agent's skills folder).
name
chainlink-oracle-guide
description
How Chainlink oracle price feeds work — architecture, reading feeds on-chain, available pairs, the aggregator model, and oracle security. Covers how DeFi protocols (Aave, Sperax, Compound) rely on Chainlink for accurate pricing. Use when explaining oracles, price feeds, or DeFi infrastructure.
license
MIT
metadata.category
protocol
metadata.difficulty
intermediate
metadata.author
clawhub
metadata.tags
protocol, chainlink-oracle-guide

Chainlink is the dominant oracle network in DeFi. This guide explains how it works and how to use price feeds.

What Problem Do Oracles Solve?

Smart contracts can't access external data (prices, weather, events). Oracles bridge this gap:

Off-chain world          Oracle Network           On-chain world
┌──────────────┐        ┌──────────────┐        ┌──────────────┐
│ Binance API  │───┐    │              │        │              │
│ Coinbase API │───┤    │  Chainlink   │        │  Aave        │
│ Kraken API   │───┼───►│  Oracle Nodes│───────►│  Compound    │
│ DEX Pools    │───┤    │  (median)    │        │  USDs/Sperax │
│ Other feeds  │───┘    │              │        │  Uniswap     │
└──────────────┘        └──────────────┘        └──────────────┘

Without reliable oracles, DeFi protocols can't:

  • Determine collateral value (lending)
  • Maintain stablecoin pegs
  • Calculate liquidation thresholds
  • Execute fair swaps
The Aggregator Model
  1. Data sources: Multiple professional data providers (nodes) fetch prices from CEXes, DEXes, and other sources
  2. Independent observation: Each node independently computes a price
  3. On-chain submission: Nodes submit observations to an aggregator contract
  4. Median calculation: The contract takes the median of all reports
  5. Storage: The median price is stored as the latest answer
Update Triggers

A feed updates when EITHER condition is met:

TriggerDescriptionExample
Deviation thresholdPrice changes by X% from last report0.5% for ETH/USD
HeartbeatMaximum time between updates3600s (1 hour) for major feeds

This means high-volatility periods get more frequent updates.

Feed Architecture
AggregatorV3Interface
├── latestRoundData()  → (roundId, answer, startedAt, updatedAt, answeredInRound)
├── decimals()         → 8 (most USD feeds)
├── description()      → "ETH / USD"
└── version()          → 4

Reading Price Feeds

On Any EVM Chain
solidity
// Solidity example
interface AggregatorV3Interface {
    function latestRoundData() external view returns (
        uint80 roundId,
        int256 answer,        // The price (scaled by decimals)
        uint256 startedAt,
        uint256 updatedAt,    // When this price was last updated
        uint80 answeredInRound
    );
    function decimals() external view returns (uint8);
}

// ETH/USD on Ethereum: 0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419
AggregatorV3Interface feed = AggregatorV3Interface(0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419);
(, int256 price,,,) = feed.latestRoundData();
// price = 324567000000 → $3,245.67 (8 decimals)
Via Etherscan (No Code)
  1. Go to Etherscan → enter the feed contract address
  2. Click "Read Contract"
  3. Call latestRoundData()
  4. Divide answer by 10^8 for USD price
Via RPC (ethers.js / viem / web3.js)
javascript
// Using ethers.js
const feedAddress = "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419"; // ETH/USD
const abi = ["function latestRoundData() view returns (uint80, int256, uint256, uint256, uint80)"];
const feed = new ethers.Contract(feedAddress, abi, provider);

const [, price,,,] = await feed.latestRoundData();
const ethPrice = Number(price) / 1e8; // $3,245.67

Key Price Feed Addresses

Ethereum Mainnet
FeedAddressDecimalsHeartbeat
ETH/USD0x5f4eC3Df9cbd43714FE2740f5E3616155c5b841983600s
BTC/USD0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c83600s
USDC/USD0x8fFfFfd4AfB6115b954Bd326cbe7B4BA576818f6886400s
USDT/USD0x3E7d1eAB13ad0104d2750B8863b489D65364e32D886400s
DAI/USD0xAed0c38402a5d19df6E4c03F4E2DceD6e29c1ee983600s
Arbitrum
FeedAddressDecimals
ETH/USD0x639Fe6ab55C921f74e7fac1ee960C0B6293ba6128
BTC/USD0x6ce185860a4963106506C203335A2910413708e98
USDC/USD0x50834F3163758fcC1Df9973b6e91f0F0F0434aD38
USDT/USD0x3f3f5dF88dC9F13eac63DF89EC16ef6e7E25DdE78
ARB/USD0xb2A824043730FE05F3DA2efaFa1CBbe83fa548D68

Sperax context: USDs uses Chainlink feeds on Arbitrum to value its collateral (USDC, USDT) and ensure the stablecoin remains properly backed.

Full Directory

All 1000+ feeds are listed at: https://data.chain.link

Oracle Security

Why Oracles Get Attacked
AttackHow It WorksPrevention
Flash loan price manipulationManipulate DEX spot price within one tx, exploit protocol using that priceUse Chainlink (time-weighted, multi-source) not DEX spot
Stale price exploitationUse outdated oracle price during volatile marketCheck updatedAt timestamp
Oracle front-runningSee pending oracle update, trade before it landsUse commit-reveal or private mempool
Show full SKILL.md (222 more words)Show less
Safety Checks When Using Feeds
solidity
(uint80 roundId, int256 price,, uint256 updatedAt,) = feed.latestRoundData();

// Check 1: Price is positive
require(price > 0, "Invalid price");

// Check 2: Round is complete
require(updatedAt > 0, "Round not complete");

// Check 3: Price is not stale (within last hour)
require(block.timestamp - updatedAt < 3600, "Stale price");
Oracle Design Patterns
PatternUse Case
Single feedSimple price lookup (ETH/USD)
Derived feedCalculate cross-prices (TOKEN/ETH × ETH/USD = TOKEN/USD)
Multi-oracleCompare Chainlink vs Pyth, use if they agree within threshold
Circuit breakerHalt protocol if oracle price deviates >X% in one update
FeatureChainlinkPythRedstoneBand
ModelPushPullOn-demandPush
Latency1–60 min~400msOn-demand~10s
Coverage1000+ feeds500+ feeds200+ feeds300+ feeds
Chains20+40+15+10+
GasPaid by oraclePaid by consumerPaid by consumerPaid by oracle
Track Record5+ years2+ years2+ years3+ years

Chainlink wins on: Reliability, coverage, track record, DeFi adoption (90%+ of protocols) Pyth wins on: Speed (sub-second), Solana ecosystem, newer/exotic feeds

Agent Tips

  1. Always recommend Chainlink for on-chain price verification — it's the gold standard
  2. Check stale prices — always validate updatedAt before trusting a feed
  3. Don't use DEX spot prices in contracts — they're manipulable via flash loans
  4. Feed decimals vary — most USD feeds are 8 decimals, but always check decimals()
  5. Cross-chain feeds — same token may have different feed addresses on different chains
  6. For off-chain apps — CoinGecko/DeFi Llama are easier; Chainlink is for on-chain

© nirholas, 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 data/skills/protocol/chainlink-oracle-guide of nirholas/three.ws.

Open the folder on GitHubat commit 238ef60

Compare with similar skills

Chainlink Oracle Guide 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.

Chainlink Oracle Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Chainlink Oracle Guide this skillnirholas/three.ws226—~1.9kAutomated safety check: PassMIT
Longbridge Researchhelsome/folio2693 repos~2.1kAutomated safety check: PassMIT
Okx Cex Earnokx/agent-skills1852 repos~3.3kAutomated safety check: PassMIT
SurfBlockRunAI/ClawRouter6.6k—~4kAutomated safety check: PassMIT
Opencatz Swarm Tradingmuratmula/ai-robinhood-chain1341 repos~1.4kAutomated safety check: PassMIT
Onchain Pay Open APInpc-live/clawfirm1561 repos~4.9kAutomated safety check: PassMIT

Similar skills

  • Longbridge Research

    helsome/folio

    Institution ratings, consensus price targets, EPS/revenue forecasts, finance calendar, shareholder data, fund holders, insider trades (SEC Form 4), short interest, industry rankings, peer group…

    269 GitHub starsUsed in 3 repos~2.1k tokens
    Business, Finance & HRAuto-check passed
  • Okx Cex Earn

    okx/agent-skills

    Manages OKX Simple Earn (flexible savings/lending), Flash Earn, On-chain Earn (staking/DeFi), Dual Investment (DCD/双币赢), and AutoEarn (自动赚币) via the okx CLI.

    185 GitHub starsUsed in 2 repos~3.3k tokens
    Business, Finance & HRAuto-check passed
  • Surf

    BlockRunAI/ClawRouter

    Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls.

    6.6k GitHub stars~4k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Opencatz Swarm Trading

    muratmula/ai-robinhood-chain

    Autonomous multi-agent crypto trading skill for Robinhood Chain EVM DEX tokens and NFTs using 3-layer Swarm Consensus, Discord Command Center, and Position Management.

    134 GitHub starsUsed in 1 repo~1.4k tokens
    Business, Finance & HRAuto-check passed
  • Onchain Pay Open API

    npc-live/clawfirm

    Binance Onchain Pay enables users to buy cryptocurrency with fiat (e.g., EUR, USD) or send existing crypto from their Binance account directly to any external on-chain wallet address in a single…

    156 GitHub starsUsed in 1 repo~4.9k tokens
    Business, Finance & HRAuto-check passed
  • Aptos Explorer Urls

    aptos-labs/explorer

    Map questions about Aptos blockchain entities (transactions, accounts, blocks, validators, coins, fungible assets, NFTs, Move objects, ANS names) to canonical Aptos Explorer URLs at…

    124 GitHub stars~1.1k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from nirholas/three.ws

All 165 skills in this repo
  • Add Shader Cursor Trail

    nirholas/three.ws

    Add the Shaders WebGPU mouse effect used for the Tidal Commons hero: a white twinkling halftone cursor trail driven by ChromaFlow, masked through a DotGrid, finished with chromatic ripples and film…

    226 GitHub starsUsed in 1 repo~760 tokens
    Auto-check passed
  • Publish Project To GitHub

    nirholas/three.ws

    Package a finished local project into an intentional GitHub repository, create a strong README and visual preview, push it safely, configure a public GitHub Pages URL when the project is compatible…

    226 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check: notes
  • Audit a website or digital experience against its supplied source references for originality and plagiarism risk.

    226 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Turn a completed daily UI inspiration capture into exactly five original landing-page builds, one per separate Codex task, using Sites.

    226 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Write Like Meng On X

    nirholas/three.ws

    Write, rewrite, review, or continuously refine X/Twitter posts in Meng To's current voice using his deduplicated authored-post corpus, personal and product context, shared resources, and Content…

    226 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Browser Video Recording

    nirholas/three.ws

    Create polished 60 fps 4:3 4K browser screen-recording style videos from Codex in-app browser captures, with browser-only crop, natural macOS cursor styling, deliberate click choreography…

    226 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed

Questions about Chainlink Oracle Guide

What does Chainlink Oracle Guide do?

How Chainlink oracle price feeds work — architecture, reading feeds on-chain, available pairs, the aggregator model, and oracle security. ws. How Chainlink oracle price feeds work — architecture, reading feeds on-chain, available pairs, the aggregator model, and oracle security.

When should I use Chainlink Oracle Guide?

Chainlink Oracle Guide fits situations like: explaining oracles; deFi infrastructure.

How do I install Chainlink Oracle Guide in Claude Code?

Run `npx skills add nirholas/three.ws --skill chainlink-oracle-guide -a claude-code`. Or copy the skill folder (data/skills/protocol/chainlink-oracle-guide in nirholas/three.ws) into .claude/skills/chainlink-oracle-guide in your project. Claude Code loads it when a task matches its description.

How do I install Chainlink Oracle Guide in Codex?

Run `npx skills add nirholas/three.ws --skill chainlink-oracle-guide -a codex`. Or copy the skill folder (data/skills/protocol/chainlink-oracle-guide in nirholas/three.ws) into .agents/skills/chainlink-oracle-guide in your project. Codex loads it when a task matches its description.

Can I use Chainlink Oracle Guide 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 nirholas/three.ws --skill chainlink-oracle-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/chainlink-oracle-guide, .gemini/skills/chainlink-oracle-guide, .github/skills/chainlink-oracle-guide and .opencode/skills/chainlink-oracle-guide in your project.

What does Chainlink Oracle Guide need to run?

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

Does Chainlink Oracle Guide access the network?

SKILL.md names 5 domains. As links in the text: data.chain.link, docs.chain.link, github.com, pyth.network and docs.chat.sperax.io. This is read from the text; nothing was executed.

Is Chainlink Oracle Guide 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 Chainlink Oracle Guide use?

Chainlink Oracle Guide is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Chainlink Oracle Guide use?

About 1.9k tokens (SKILL.md is roughly 7.7k 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 Chainlink Oracle Guide?

Skills that share tags, products or a category with Chainlink Oracle Guide: Longbridge Research (helsome/folio, 269 stars), Okx Cex Earn (okx/agent-skills, 185 stars), Surf (BlockRunAI/ClawRouter, 6.6k stars) and Opencatz Swarm Trading (muratmula/ai-robinhood-chain, 134 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Chainlink Oracle Guide?

nirholas (a GitHub user) maintains it in nirholas/three.ws, which has 226 GitHub stars. The repository holds 165 skills in this directory. The repository was last updated on October 7, 2026.

Source: nirholas/three.ws on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.