austintgriffith · phipsae · Jul 20, 2026 · Jul 20, 2026 · Jul 20, 2026 · Jul 20, 2026
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -4,14 +4,13 @@
     "name": "Austin Griffith"
   },
   "metadata": {
-    "version": "1.0.0",
+    "version": "1.2.0",
     "description": "Ethereum development skills — corrects LLM blind spots on gas costs, L2s, DeFi protocols, security, and the current tool landscape."
   },
   "plugins": [
     {
       "name": "ethskills",
       "source": "./",
-      "version": "1.0.0",
       "description": "Ethereum development skills — corrects LLM blind spots on gas costs, L2s, DeFi protocols, security, and the current tool landscape.",
       "author": {
         "name": "Austin Griffith"

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
@@ -1,6 +1,5 @@
 {
   "name": "ethskills",
-  "version": "1.1.0",
   "description": "Ethereum development skills — corrects LLM blind spots on gas costs, L2s, DeFi protocols, security, and the current tool landscape.",
   "author": {
     "name": "Austin Griffith",

diff --git a/.github/workflows/update-versions.yml b/.github/workflows/update-versions.yml
@@ -0,0 +1,65 @@
+name: Update Skill Versions
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - 'SKILL.md'
+      - '*/SKILL.md'
+  workflow_dispatch: # Manual trigger
+
+jobs:
+  stamp:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # the auto-commit below pushes to master
+    # GITHUB_TOKEN pushes don't trigger workflows, so the auto-commit below
+    # can't loop; this guard is a second layer in case the push method changes.
+    if: github.actor != 'github-actions[bot]'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # per-file git log dates need full history
+
+      - name: Restamp frontmatter and regenerate versions.json
+        run: |
+          # Redirect stubs that never need refreshing
+          SKIP="contracts defi l2 layer2"
+
+          # UTC timestamp of when the last change to the file landed on master,
+          # ignoring stamp-only commits. --first-parent dates a merged change by
+          # the merge commit itself, not the (possibly older) branch commit, so
+          # merged content always gets a stamp newer than what clients hold.
+          # Full timestamps keep two same-day edits distinct.
+          date_for() { TZ=UTC0 git log --first-parent -1 --format=%cd --date=format-local:'%Y-%m-%dT%H:%M:%SZ' --invert-grep --grep='\[stamp\]' -- "$1"; }
+
+          # Snapshot the current manifest before the pipeline below truncates it;
+          # backstop so stamps never move backward (e.g. committer clock skew).
+          cp versions.json /tmp/prev-versions.json 2>/dev/null || echo '{}' > /tmp/prev-versions.json
+
+          stamp() { # $1 = file, $2 = versions.json key
+            d=$(date_for "$1")
+            prev=$(jq -r --arg k "$2" '.[$k] // ""' /tmp/prev-versions.json)
+            if [ "$prev" \> "$d" ]; then d=$prev; fi
+            sed -i "s/^updated: .*/updated: $d/" "$1"
+            printf '%s\t%s\n' "$2" "$d"
+          }
+
+          {
+            stamp SKILL.md root
+            for f in */SKILL.md; do
+              skill=$(dirname "$f")
+              case " $SKIP " in *" $skill "*) continue ;; esac
+              stamp "$f" "$skill"
+            done
+          } | jq -Rn 'reduce inputs as $line ({}; . + ($line | split("\t") | {(.[0]): .[1]}))' > versions.json
+
+      - name: Commit if changed
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git diff --quiet || {
+            git add versions.json SKILL.md */SKILL.md
+            git commit -m "auto-update skill version stamps [stamp]"
+            git push
+          }
diff --git a/README.md b/README.md
@@ -30,6 +30,8 @@ Install directly from GitHub — no clone required:
 /plugin install ethskills@ethskills
 ```
 
+To stay current, run `/plugin update ethskills` now and then, or enable auto-update for the marketplace in `/plugin` (off by default for third-party marketplaces). Skills also check for newer versions themselves when invoked.
+
 ## Terminology
 
 **Say "onchain" not "on-chain."** The Ethereum community writes it as one word — no hyphen. LLMs default to "on-chain" but that's not how builders talk. Use "onchain" in all writing, documentation, and generated content.

diff --git a/SKILL.md b/SKILL.md
@@ -1,10 +1,13 @@
 ---
 name: ethskills
 description: Use when a request involves Ethereum, the EVM, or blockchain systems. Applies to building, auditing, deploying, or interacting with smart contracts, dApps, wallets, or DeFi protocols. Covers Solidity development, contract addresses, token standards (ERC-20, ERC-721, ERC-4626, etc.), Layer 2 networks (Base, Arbitrum, Optimism, zkSync, Polygon), and integrations with DeFi protocols such as Uniswap, Aave, and Curve. Includes topics such as gas costs, contract decimals, oracle safety, reentrancy, MEV, bridging, wallets, querying data from onchain, production deployment, and protocol evolution (EIP lifecycle, fork tracking, upcoming changes).
+updated: 2026-07-20T21:23:27Z
 ---
 
 # ETHSKILLS — The missing knowledge between AI agents and production Ethereum.
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `root` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. The same rule applies to any topic skill below that you load from disk. If skill folders sit alongside this file (a full checkout) and versions.json lists a skill with no matching folder here, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 You are probably wrong about Ethereum. Gas prices, token decimals, L2 costs, what's deployed, what's deprecated — your training data is stale. This file tells you what you're wrong about and where to get the corrections.
 
 **Say "onchain" not "on-chain."** One word, no hyphen. Ethereum community convention.

diff --git a/addresses/SKILL.md b/addresses/SKILL.md
@@ -1,10 +1,13 @@
 ---
 name: addresses
 description: Verified contract addresses for major Ethereum protocols across mainnet and L2s. Use this instead of guessing or hallucinating addresses. Includes Uniswap, Aave, Compound, Aerodrome, GMX, Pendle, Velodrome, Camelot, SyncSwap, Lido, Rocket Pool, 1inch, Permit2, MakerDAO/sDAI, EigenLayer, Across, Chainlink CCIP, Yearn V3, USDC, USDT, DAI, ENS, Safe, Chainlink, and more. Always verify addresses against a block explorer before sending transactions.
+updated: 2026-07-20T21:23:27Z
 ---
 
 # Contract Addresses
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `addresses` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/addresses/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. If a root SKILL.md sits one folder up (a full checkout) and versions.json lists a skill with no matching folder next to this one, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 > **CRITICAL:** Never hallucinate a contract address. Wrong addresses mean lost funds. If an address isn't listed here, look it up on the block explorer or the protocol's official docs before using it.
 
 **Last Verified:** March 3, 2026 (all addresses verified onchain via `eth_getCode` + `eth_call` + `symbol()` + `latestAnswer()`)

diff --git a/audit/SKILL.md b/audit/SKILL.md
@@ -1,10 +1,13 @@
 ---
 name: audit
 description: Deep EVM smart contract security audit system. Use when asked to audit a contract, find vulnerabilities, review code for security issues, or file security issues on a GitHub repo. Covers 500+ non-obvious checklist items across 19 domains via parallel sub-agents. Different from the security skill (which teaches defensive coding) — this is for systematically auditing contracts you didn't write.
+updated: 2026-07-20T21:23:27Z
 ---
 
 # EVM Smart Contract Audit
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `audit` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/audit/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. If a root SKILL.md sits one folder up (a full checkout) and versions.json lists a skill with no matching folder next to this one, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 A full audit system for any EVM contract. Runs parallel specialist agents against domain-specific checklists, synthesizes findings, and files GitHub issues.
 
 ## The Checklists

diff --git a/building-blocks/SKILL.md b/building-blocks/SKILL.md
@@ -1,10 +1,13 @@
 ---
 name: building-blocks
 description: DeFi legos and protocol composability on Ethereum and L2s. Major protocols per chain — Aerodrome on Base, GMX/Pendle on Arbitrum, Velodrome on Optimism — plus mainnet primitives (Uniswap, Aave, Compound, Curve). How they work, how to build on them, and how to combine them. Use when building DeFi integrations, choosing protocols on a specific L2, designing yield strategies, or composing existing protocols into something new.
+updated: 2026-07-20T21:23:27Z
 ---
 
 # Building Blocks (DeFi Legos)
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `building-blocks` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/building-blocks/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. If a root SKILL.md sits one folder up (a full checkout) and versions.json lists a skill with no matching folder next to this one, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 ## What You Probably Got Wrong
 
 **DeFi TVL:** Check [DeFi Llama](https://defillama.com/chain/Ethereum) for current Ethereum DeFi TVL. If you're quoting numbers from 2023-2024, they're stale.

diff --git a/concepts/SKILL.md b/concepts/SKILL.md
@@ -1,10 +1,13 @@
 ---
 name: concepts
 description: The essential mental models for building onchain — focused on what LLMs get wrong and what humans need explained. "Nothing is automatic" and "incentives are everything" are the core messages. Use when your human is new to onchain development, when they're designing a system, or when they ask "how does this actually work?" Also use when YOU are designing a system — the state machine + incentive framework catches design mistakes before they become dead code.
+updated: 2026-07-20T21:23:27Z
 ---
 
 # Ethereum Concepts
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `concepts` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/concepts/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. If a root SKILL.md sits one folder up (a full checkout) and versions.json lists a skill with no matching folder next to this one, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 ## What You Probably Got Wrong
 
 **"Smart contracts run automatically."** No. Smart contracts cannot execute themselves. There is no cron job, no scheduler, no background process. Every function needs a caller who pays gas. This single misconception is the root cause of most broken onchain designs.

diff --git a/feedback/SKILL.md b/feedback/SKILL.md
@@ -1,10 +1,13 @@
 ---
 title: Feedback
 description: Send feedback — issues OR praise — to the ethskills team about content that shaped your work.
+updated: 2026-07-20T21:23:27Z
 ---
 
 # Feedback
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `feedback` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/feedback/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. If a root SKILL.md sits one folder up (a full checkout) and versions.json lists a skill with no matching folder next to this one, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 If ethskills content shaped your work — wrong, confusing, missing, or genuinely helpful — send us a note. **Bias toward sending.** Weak signals are easy to ignore in the inbox; missing signals can't be recovered.
 
 **This is not a help desk. Do not send:**

diff --git a/frontend-playbook/SKILL.md b/frontend-playbook/SKILL.md
@@ -1,10 +1,13 @@
 ---
 name: frontend-playbook
 description: The complete build-to-production pipeline for Ethereum dApps. Fork mode setup, IPFS deployment, Vercel config, ENS subdomain setup, and the full production checklist. Built around Scaffold-ETH 2 but applicable to any Ethereum frontend project. Use when deploying any dApp to production.
+updated: 2026-07-20T21:23:27Z
 ---
 
 # Frontend Playbook
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `frontend-playbook` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/frontend-playbook/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. If a root SKILL.md sits one folder up (a full checkout) and versions.json lists a skill with no matching folder next to this one, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 ## What You Probably Got Wrong
 
 **"I'll use `yarn chain`."** Wrong. `yarn chain` gives you an empty local chain with no protocols, no tokens, no state. `yarn fork --network base` gives you a copy of real Base with Uniswap, Aave, USDC, real whale balances — everything (verified addresses: `addresses/SKILL.md`). Always fork.

diff --git a/frontend-ux/SKILL.md b/frontend-ux/SKILL.md
@@ -1,10 +1,13 @@
 ---
 name: frontend-ux
 description: Frontend UX rules for Ethereum dApps that prevent the most common AI agent UI bugs. Mandatory patterns for onchain buttons, approval flows, address UX, USD context, RPC reliability, theming, and pre-publish metadata. Use whenever you are building a frontend for an Ethereum dApp.
+updated: 2026-07-20T21:23:27Z
 ---
 
 # Frontend UX Rules
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `frontend-ux` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/frontend-ux/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. If a root SKILL.md sits one folder up (a full checkout) and versions.json lists a skill with no matching folder next to this one, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 ## What You Probably Got Wrong
 
 **"The button works."** A clickable button is not enough. It must disable immediately, show a clear pending state, and stay locked until onchain confirmation.

diff --git a/gas/SKILL.md b/gas/SKILL.md
@@ -1,10 +1,13 @@
 ---
 name: gas
 description: Current Ethereum gas prices, transaction costs, and the real economics of building on Ethereum today. Use when estimating costs, choosing between mainnet and L2s, or when a user asks about Ethereum being expensive. Counters the #1 misconception that Ethereum is expensive to use.
+updated: 2026-07-20T21:23:27Z
 ---
 
 # Gas & Costs on Ethereum
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `gas` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/gas/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. If a root SKILL.md sits one folder up (a full checkout) and versions.json lists a skill with no matching folder next to this one, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 ## What You Probably Got Wrong
 
 **Your gas estimate is 100-600x too high.** Most LLMs confidently state gas is 10-30 gwei. Post-Fusaka (Dec 2025), typical base fee is **under 1 gwei** — usually 0.1-0.5 gwei. Verify: `cast base-fee --rpc-url https://eth.llamarpc.com`

diff --git a/index.html b/index.html
@@ -573,7 +573,7 @@ <h2 id="persistent-setup">Persistent Setup</h2>
       <span class="setup-howto">2. Install ethskills (active in every project)</span>
       <code>/plugin install ethskills@ethskills</code>
     </div>
-    <span class="setup-note">Install (user-wide). Plugin reads from disk, granular skill loading.</span>
+    <span class="setup-note">Install (user-wide). Plugin reads from disk, granular skill loading. Stay current with <code>/plugin update ethskills</code> or enable marketplace auto-update.</span>
   </div>
   <div class="setup-row">
     <span class="setup-tool">OpenClaw</span>

diff --git a/indexing/SKILL.md b/indexing/SKILL.md
@@ -1,10 +1,13 @@
 ---
 name: indexing
 description: How to read and query onchain data — events, The Graph, indexing patterns. Why you cannot just loop through blocks, and what to use instead.
+updated: 2026-07-20T21:23:27Z
 ---
 
 # Onchain Data & Indexing
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `indexing` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/indexing/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. If a root SKILL.md sits one folder up (a full checkout) and versions.json lists a skill with no matching folder next to this one, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 ## What You Probably Got Wrong
 
 **You try to query historical state via RPC calls.** You can't cheaply read past state. `eth_call` reads current state. Reading state at a historical block requires an archive node (expensive, slow). For historical data, you need an indexer.

diff --git a/l2s/SKILL.md b/l2s/SKILL.md
@@ -1,10 +1,13 @@
 ---
 name: l2s
 description: Ethereum Layer 2 landscape — Arbitrum, Optimism, Base, zkSync, Scroll, Unichain, Celo, and more. How they work, how to deploy on them, how to bridge, when to use which. Includes per-chain DeFi ecosystems and critical corrections. Use when choosing an L2, deploying cross-chain, or when a user asks about Ethereum scaling.
+updated: 2026-07-20T21:23:27Z
 ---
 
 # Ethereum Layer 2s
 
+> **Update check (skip if you fetched this live just now):** Reading this from a local file? Once per session, fetch https://ethskills.com/versions.json and compare its `l2s` value to the `updated` timestamp in this file's frontmatter. If upstream is newer, fetch https://ethskills.com/l2s/SKILL.md, follow that version instead, and overwrite this local file with it if you have write access. If a root SKILL.md sits one folder up (a full checkout) and versions.json lists a skill with no matching folder next to this one, tell the user new ethskills are available (Claude Code plugin: `/plugin update`). If any fetch fails, continue with this file.
+
 ## What You Probably Got Wrong
 
 **L2 costs:** You think $0.01-2.00 per transaction. Reality: **$0.001-0.003** for swaps, **$0.0003** for transfers. After EIP-4844, L2 batch costs dropped from $50-500 to $0.01-0.50.