fix: point ECOSYSTEM_CARDS copyValue at raw content, not GitHub's blob HTML page

.github/workflows/deploy-pages.yml

@@ -59,6 +59,8 @@ jobs:
 
       - run: pnpm lint:ts
 
+      - run: pnpm check:ecosystem-links
+
       - run: pnpm build
 
       - name: Verify hero text matches SITE_ORIGIN (no subpath leak)

.github/workflows/preview-pr.yml

@@ -98,6 +98,9 @@ jobs:
       - if: github.event.action != 'closed'
         run: pnpm lint:ts
 
+      - if: github.event.action != 'closed'
+        run: pnpm check:ecosystem-links
+
       - if: github.event.action != 'closed'
         run: pnpm build
 

site/README.md

@@ -150,15 +150,19 @@ Append to `ECOSYSTEM_CARDS` in `src/data/skills.ts`:
   title: "Project Name",
   description: "Verb-led summary of what the skill does.",
   pathLabel: "owner/repo",
-  copyValue: "https://github.com/owner/repo/blob/main/path/to/SKILL.md",
+  copyValue: "https://raw.githubusercontent.com/owner/repo/main/path/to/SKILL.md",
 }
 ```
 
 - `pathLabel` is the short label shown on the card (typically
   `owner/repo`).
 - `copyValue` is the full URL written to the clipboard when the user
   clicks the pill — point it directly at the raw SKILL.md so an agent
-  can fetch it.
+  can fetch it. For a GitHub-hosted skill that means
+  `raw.githubusercontent.com`, **not** a `github.com/.../blob/...` URL:
+  the latter serves an HTML page (`content-type: text/html`), not the
+  markdown itself, which is what earlier entries in `ECOSYSTEM_CARDS`
+  got wrong by following this example before it was fixed.
 
 Run `pnpm dev` to verify the card renders. No `sync:skills` step
 needed since ecosystem entries aren't mirrored locally.

site/package.json

@@ -9,6 +9,7 @@
   "scripts": {
     "sync:skills": "node scripts/copy-skills.mjs",
     "generate:llms-txt": "node --experimental-strip-types --disable-warning=ExperimentalWarning --disable-warning=MODULE_TYPELESS_PACKAGE_JSON scripts/generate-llms-txt.mjs",
+    "check:ecosystem-links": "node --experimental-strip-types --disable-warning=ExperimentalWarning --disable-warning=MODULE_TYPELESS_PACKAGE_JSON scripts/check-ecosystem-links.mjs",
     "predev": "node scripts/copy-skills.mjs --cached --lenient && pnpm generate:llms-txt",
     "dev": "next dev",
     "prebuild": "node scripts/copy-skills.mjs && pnpm generate:llms-txt",

site/scripts/check-ecosystem-links.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * Fails if any ECOSYSTEM_CARDS entry's `copyValue` points at GitHub's
+ * HTML blob viewer (`github.com/.../blob/...`) instead of raw content.
+ *
+ * `copyValue` is written directly into `public/llms.txt`'s "Community
+ * Built" section by generate-llms-txt.mjs, and is the exact string an
+ * agent fetches to install the skill, so it has to resolve to markdown
+ * (`raw.githubusercontent.com/...`), not GitHub's rendered page
+ * (`content-type: text/html`, not `text/plain` or `text/markdown`).
+ * Static check, no network calls: catches the mistake at review time
+ * instead of relying on a future skills.stellar.org/llms.txt spot check.
+ */
+import { ECOSYSTEM_CARDS } from "../src/data/skills.ts";
+
+const BLOB_PATTERN = /^https:\/\/github\.com\/[^/]+\/[^/]+\/blob\//;
+
+const offenders = ECOSYSTEM_CARDS.filter((c) => BLOB_PATTERN.test(c.copyValue));
+
+if (offenders.length > 0) {
+  console.error(
+    `[check-ecosystem-links] ${offenders.length} ECOSYSTEM_CARDS entr${offenders.length === 1 ? "y uses" : "ies use"} a github.com/.../blob/... copyValue instead of raw.githubusercontent.com:`,
+  );
+  for (const c of offenders) {
+    console.error(`  - "${c.title}": ${c.copyValue}`);
+  }
+  console.error(
+    "\nRewrite as https://raw.githubusercontent.com/<owner>/<repo>/<branch>/<path>.",
+  );
+  process.exit(1);
+}
+
+console.log(
+  `[check-ecosystem-links] ${ECOSYSTEM_CARDS.length} entries checked, no blob-URL copyValue found`,
+);

site/src/data/skills.ts

@@ -149,141 +149,141 @@ export const ECOSYSTEM_CARDS: readonly EcosystemCardSource[] = [
       "Scaffold a Stellar smart contract project with OpenZeppelin's audited Stellar contract libraries. Walks through Rust toolchain setup, Stellar CLI install, workspace dependencies, and applying the pausable and ownable macros to your contract.",
     pathLabel: "OpenZeppelin/openzeppelin-skills",
     copyValue:
-      "https://github.com/OpenZeppelin/openzeppelin-skills/blob/main/skills/setup-stellar-contracts/SKILL.md",
+      "https://raw.githubusercontent.com/OpenZeppelin/openzeppelin-skills/main/skills/setup-stellar-contracts/SKILL.md",
   },
   {
     title: "DeFindex SDK",
     description:
       "Integrate DeFindex vaults on Stellar with the @defindex/sdk TypeScript package. Covers vault deposits and withdrawals, balance and APY queries, programmatic vault creation, and the unsigned-XDR signing pattern for backend and bot integrations.",
     pathLabel: "paltalabs/defindex-sdk",
     copyValue:
-      "https://github.com/paltalabs/defindex-sdk/blob/main/defindex-sdk-skill.md",
+      "https://raw.githubusercontent.com/paltalabs/defindex-sdk/main/defindex-sdk-skill.md",
   },
   {
     title: "Soroswap SDK",
     description:
       "Trade on Soroswap DEX from a backend, bot, or swap widget using the @soroswap/sdk TypeScript package. Covers token swaps, liquidity pool operations, price and route queries, API key handling, and signing flows for both server keypairs and browser wallets.",
     pathLabel: "soroswap/sdk",
-    copyValue: "https://github.com/soroswap/sdk/blob/main/soroswap-sdk-skill.md",
+    copyValue: "https://raw.githubusercontent.com/soroswap/sdk/main/soroswap-sdk-skill.md",
   },
   {
     title: "Trustless Work Escrow",
     description:
       "Build escrow and milestone-based payment workflows on Stellar with the Trustless Work platform. Covers single-release and multi-release escrows, trustline configuration, dispute handling, and three integration paths: REST API, React SDK hooks, and pre-built Blocks UI components.",
     pathLabel: "Trustless-Work/trustless-work-dev-skill",
     copyValue:
-      "https://github.com/Trustless-Work/trustless-work-dev-skill/blob/main/SKILL.md",
+      "https://raw.githubusercontent.com/Trustless-Work/trustless-work-dev-skill/main/SKILL.md",
   },
   {
     title: "Agent Browser WebAuthn",
     description:
       "Drive passkey and Stellar smart account browser tests with agent-browser and Chrome DevTools virtual WebAuthn authenticators.",
     pathLabel: "kalepail/skills",
     copyValue:
-      "https://github.com/kalepail/skills/blob/main/skills/agent-browser-webauthn/SKILL.md",
+      "https://raw.githubusercontent.com/kalepail/skills/main/skills/agent-browser-webauthn/SKILL.md",
   },
   {
     title: "Anchors",
     description:
       "Integrate with or build Stellar anchors (fiat on/off-ramps, deposits/withdrawals, KYC). Covers core SEP flows (1/6/10/12/24/31/38) and common integration pitfalls.",
     pathLabel: "CheesecakeLabs/stellar-anchor-skill",
     copyValue:
-      "https://github.com/CheesecakeLabs/stellar-anchor-skill/blob/main/SKILL.md",
+      "https://raw.githubusercontent.com/CheesecakeLabs/stellar-anchor-skill/main/SKILL.md",
   },
   {
     title: "Eunomia Bounded Agent Treasury",
     description:
       "Give an AI agent a non-custodial, contract-bounded spending account on Stellar with Eunomia (formerly PRISM). Covers treasury deployment with per-payment and rolling daily limits, payee whitelists, time-bound agent session keys, escrow, x402-gated payments, and Groth16/BN254 ZK compliance proofs verified on-chain.",
     pathLabel: "eunomia-finance/eunomia",
-    copyValue: "https://github.com/eunomia-finance/eunomia/blob/main/SKILL.md",
+    copyValue: "https://raw.githubusercontent.com/eunomia-finance/eunomia/main/SKILL.md",
   },
   {
     title: "ROZO Intents",
     description:
       "Send USDC and USDT across Stellar, Ethereum, Arbitrum, Base, BSC, Polygon, and Solana using natural language. Covers cross-chain bridging, wallet detection, fee estimation, tiered confirmation logic, and QR code payment parsing inside Claude Code.",
     pathLabel: "RozoAI/rozo-intents-skills",
     copyValue:
-      "https://github.com/RozoAI/rozo-intents-skills/blob/main/SKILL.md",
+      "https://raw.githubusercontent.com/RozoAI/rozo-intents-skills/main/SKILL.md",
   },
   {
     title: "Caatinga",
     description:
       "Deploy and manage Soroban contract lifecycles with the Caatinga CLI (ctg). Covers the init → doctor → build → deploy → generate → invoke workflow, the multi-contract Deployment Graph, versioned caatinga.artifacts.json as the source of truth for contract IDs, generated TypeScript bindings, and wallet adapters (Freighter, Stellar Wallets Kit) — with hard rules against raw secret keys on the command line and hand-edited artifacts or bindings.",
     pathLabel: "Dione-b/caatinga-skill",
     copyValue:
-      "https://github.com/Dione-b/caatinga-skill/blob/master/skills/caatinga/SKILL.md",
+      "https://raw.githubusercontent.com/Dione-b/caatinga-skill/master/skills/caatinga/SKILL.md",
   },
   {
     title: "Sozu Testnet USDC Faucet",
     description:
       "Claim Circle USDC on Stellar testnet with a PoW-gated CLI, using an existing C…/G… address or a newly generated G… wallet with a USDC trustline.",
     pathLabel: "blessedux/agent-skills",
     copyValue:
-      "https://github.com/blessedux/agent-skills/blob/main/sozu-faucet/SKILL.md",
+      "https://raw.githubusercontent.com/blessedux/agent-skills/main/sozu-faucet/SKILL.md",
   },
   {
     title: "LumenLoop MCP Connect",
     description:
       "Connect any MCP client (Claude, ChatGPT, Gemini, Cursor) to LumenLoop's free read-only Stellar ecosystem MCP and learn its query tools for directory, content, and SCF data.",
     pathLabel: "lumenloop/lumenloop-skills",
     copyValue:
-      "https://github.com/lumenloop/lumenloop-skills/blob/main/skills/lumenloop-mcp-connect/SKILL.md",
+      "https://raw.githubusercontent.com/lumenloop/lumenloop-skills/main/skills/lumenloop-mcp-connect/SKILL.md",
   },
   {
     title: "SCF Submission Radar",
     description:
       "Position a Stellar Community Fund idea against prior submissions before applying: find similar past proposals, check what's been funded in an area, and sharpen positioning.",
     pathLabel: "lumenloop/lumenloop-skills",
     copyValue:
-      "https://github.com/lumenloop/lumenloop-skills/blob/main/skills/scf-submission-radar/SKILL.md",
+      "https://raw.githubusercontent.com/lumenloop/lumenloop-skills/main/skills/scf-submission-radar/SKILL.md",
   },
   {
     title: "Stellar Builder Quickstart",
     description:
       "Go from a Stellar product idea to a build path: pick the right primitives, check ecosystem prior art via LumenLoop, and route to the relevant build skill.",
     pathLabel: "lumenloop/lumenloop-skills",
     copyValue:
-      "https://github.com/lumenloop/lumenloop-skills/blob/main/skills/stellar-builder-quickstart/SKILL.md",
+      "https://raw.githubusercontent.com/lumenloop/lumenloop-skills/main/skills/stellar-builder-quickstart/SKILL.md",
   },
   {
     title: "Stellar Content Auditor",
     description:
       "Audit draft posts and announcements against Stellar ecosystem data: resolve project names and X handles, pull supporting citations, and flag unsupported claims.",
     pathLabel: "lumenloop/lumenloop-skills",
     copyValue:
-      "https://github.com/lumenloop/lumenloop-skills/blob/main/skills/stellar-content-auditor/SKILL.md",
+      "https://raw.githubusercontent.com/lumenloop/lumenloop-skills/main/skills/stellar-content-auditor/SKILL.md",
   },
   {
     title: "Stellar Ecosystem Digest",
     description:
       "Produce a dated, cited digest of recent Stellar ecosystem activity on a theme or entity from indexed news, talks, events, and research.",
     pathLabel: "lumenloop/lumenloop-skills",
     copyValue:
-      "https://github.com/lumenloop/lumenloop-skills/blob/main/skills/stellar-ecosystem-digest/SKILL.md",
+      "https://raw.githubusercontent.com/lumenloop/lumenloop-skills/main/skills/stellar-ecosystem-digest/SKILL.md",
   },
   {
     title: "Stellar Ecosystem Scout",
     description:
       "Map a sector of the Stellar ecosystem into a landscape of projects, categories, and regions using the LumenLoop directory and semantic search.",
     pathLabel: "lumenloop/lumenloop-skills",
     copyValue:
-      "https://github.com/lumenloop/lumenloop-skills/blob/main/skills/stellar-ecosystem-scout/SKILL.md",
+      "https://raw.githubusercontent.com/lumenloop/lumenloop-skills/main/skills/stellar-ecosystem-scout/SKILL.md",
   },
   {
     title: "Stellar Integration Finder",
     description:
       "Find the right existing Stellar project or tool to integrate (wallet, oracle, anchor, DEX, indexer) via the LumenLoop directory, then route to the matching build skill.",
     pathLabel: "lumenloop/lumenloop-skills",
     copyValue:
-      "https://github.com/lumenloop/lumenloop-skills/blob/main/skills/stellar-integration-finder/SKILL.md",
+      "https://raw.githubusercontent.com/lumenloop/lumenloop-skills/main/skills/stellar-integration-finder/SKILL.md",
   },
   {
     title: "Stellar Project Dossier",
     description:
       "Build a due-diligence profile of a single Stellar project: details, related content, talks, SCF history, and similar projects from the LumenLoop directory.",
     pathLabel: "lumenloop/lumenloop-skills",
     copyValue:
-      "https://github.com/lumenloop/lumenloop-skills/blob/main/skills/stellar-project-dossier/SKILL.md",
+      "https://raw.githubusercontent.com/lumenloop/lumenloop-skills/main/skills/stellar-project-dossier/SKILL.md",
   },
   {
     title: "Stellar Scout",
@@ -298,69 +298,69 @@ export const ECOSYSTEM_CARDS: readonly EcosystemCardSource[] = [
       "Integrate sealed coordination into Stellar apps with @sub-rosa/sdk: run sealed-bid asset auctions with SAC escrow and atomic lot settlement, confidential proposal rounds, Drand-timed reveal, permissionless lifecycle automation, and verifiable Core v2 receipts.",
     pathLabel: "karagozemin/Sub-Rosa",
     copyValue:
-      "https://github.com/karagozemin/Sub-Rosa/blob/main/skills/sub-rosa/SKILL.md",
+      "https://raw.githubusercontent.com/karagozemin/Sub-Rosa/main/skills/sub-rosa/SKILL.md",
   },
   {
     title: "ROZO Checkout",
     description:
       "Pay for AI services with Stellar USDC — e.g. OpenRouter and Venice.ai, which cannot take Stellar directly — through a one-time deposit order and automatic invoice settlement. More AI services coming.",
     pathLabel: "RozoAI/rozo-checkout-skill",
     copyValue:
-      "https://github.com/RozoAI/rozo-checkout-skill/blob/main/SKILL.md",
+      "https://raw.githubusercontent.com/RozoAI/rozo-checkout-skill/main/SKILL.md",
   },
   {
     title: "MPP Discover",
     description:
       "Find and pay APIs from 90+ services with Stellar USDC through MPP Router — including OpenAI, Anthropic, DeepSeek, Perplexity, Exa, Firecrawl, and Tavily. An agent fetches the live service catalog, picks a service, and settles per request. Every verified service is backed by a real paid call with a published Stellar transaction hash.",
     pathLabel: "mpprouter/stellar-agent-wallet-skill",
     copyValue:
-      "https://github.com/mpprouter/stellar-agent-wallet-skill/blob/main/skills/discover/SKILL.md",
+      "https://raw.githubusercontent.com/mpprouter/stellar-agent-wallet-skill/main/skills/discover/SKILL.md",
   },
   {
     title: "Stellar Agent Search",
     description:
       "Read-only, keyless MCP server that lets an AI agent discover, rank, and vet on-chain Stellar 8004 agents on mainnet by natural-language query, stopping before any payment or signing.",
     pathLabel: "berkingurcan/stellar-agent-search",
     copyValue:
-      "https://github.com/berkingurcan/stellar-agent-search/blob/main/skills/mcp/SKILL.md",
+      "https://raw.githubusercontent.com/berkingurcan/stellar-agent-search/main/skills/mcp/SKILL.md",
   },
   {
     title: "Cogladius",
     description:
       "Register an AI agent to earn XLM by completing on-chain tasks: one-call permissionless registration, task polling, solution submission, and payout from a non-custodial Soroban escrow on an ed25519-verified judge verdict.",
     pathLabel: "furkanyesildag/cogladius",
     copyValue:
-      "https://github.com/furkanyesildag/cogladius/blob/main/SKILL.md",
+      "https://raw.githubusercontent.com/furkanyesildag/cogladius/main/SKILL.md",
   },
   {
     title: "Soroban Common Mistakes",
     description:
       "Review Soroban contracts against 23 recurring security mistakes before shipping: missing authorization, storage and TTL pitfalls, arithmetic overflow, and unsafe panic handling. Ships with a reviewable checklist, a PR template, and a Scout CI workflow. Available in English and Spanish.",
     pathLabel: "mariaelisaaraya/stellar-security-guide",
     copyValue:
-      "https://github.com/mariaelisaaraya/stellar-security-guide/blob/main/skills/soroban-common-mistakes/SKILL.md",
+      "https://raw.githubusercontent.com/mariaelisaaraya/stellar-security-guide/main/skills/soroban-common-mistakes/SKILL.md",
   },
   {
     title: "StellarTools",
     description:
       "Stripe-level payment infrastructure for Stellar. Accept crypto and fiat payments with hosted checkouts, Soroban-powered subscriptions with flexible billing periods, customer portals, and normalized webhooks. Includes WooCommerce and Shopify adapters, an apps marketplace, and an MCP server for agent-driven payment management. ⁠",
     pathLabel: "payrouteshq/stellartools",
-    copyValue: "https://github.com/payrouteshq/stellartools/blob/main/SKILL.md",
+    copyValue: "https://raw.githubusercontent.com/payrouteshq/stellartools/main/SKILL.md",
   },
   {
     title: "Nirium Agentic Payments",
     description:
       "Charge AI agents per API call on Stellar with the Nirium toolkit: scaffold a working x402 seller with nirium-cli in one command, charge per route with x402Serve() from the nirium SDK, and read live protocol data, market state, autonomous loop status, and execution nodes through the nirium-mcp server. Live on mainnet since July 9, 2026.",
     pathLabel: "nirium-protocol/nirium-sdk",
     copyValue:
-      "https://github.com/nirium-protocol/nirium-sdk/blob/main/skills/nirium-agentic-payments/SKILL.md",
+      "https://raw.githubusercontent.com/nirium-protocol/nirium-sdk/main/skills/nirium-agentic-payments/SKILL.md",
   },
   {
     title: "Contextio SDK",
     description:
       "Integrate contextio-sdk: verifiable, non-custodial legal context binding (Legal Context Protocol / LCP) for Stellar treasury and payroll. Covers Sign In With Stellar (SEP-53) wallet auth, reading a tenant's treasury/payroll/agent state, triggering an agent proposal, and independently hashing/verifying an LCP document against an on-chain hash.",
     pathLabel: "Eras256/Contextio",
     copyValue:
-      "https://github.com/Eras256/Contextio/blob/main/packages/sdk/SKILL.md",
+      "https://raw.githubusercontent.com/Eras256/Contextio/main/packages/sdk/SKILL.md",
   },
 ] as const;