Implement some changes to make our docs site more accessible to agents

nginx/nginx.conf

@@ -17,6 +17,7 @@ http {
     location / {
         rewrite ^/(.*)/$ /$1 permanent;
         try_files $uri $uri.html $uri/index.html =404;
+        add_header 'Link' '</.well-known/api-catalog>; rel="api-catalog"' always;
     }
     location /assets/ {
         try_files $uri $uri/ =404;
@@ -29,9 +30,15 @@ http {
     }
     location /index.html {
         add_header 'Cache-Control' 'no-store' always;
+        add_header 'Link' '</.well-known/api-catalog>; rel="api-catalog"' always;
     }
     location /404.html {
         add_header 'Cache-Control' 'no-store' always;
+        add_header 'Link' '</.well-known/api-catalog>; rel="api-catalog"' always;
+    }
+    # RFC 9727 — extension-less file, advertise correct content type
+    location = /.well-known/api-catalog {
+        types { } default_type application/linkset+json;
     }
   }
 }

static/.well-known/agent-skills/index.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
+  "skills": [
+    {
+      "name": "agentic-payments",
+      "type": "skill-md",
+      "description": "Agentic and machine-to-machine payments on Stellar. Covers x402 (HTTP 402 paid APIs via OZ Channels facilitator, fee-sponsored clients) and MPP (Machine Payments Protocol) in both Charge mode (per-request SAC) and Channel mode (off-chain commits, high-frequency). Defaults to USDC (SEP-41 SAC) on `stellar:testnet`/`stellar:pubnet` (CAIP-2). Use when selling a paid API to AI agents, building an x402 client, or designing a payment-channel architecture for high-frequency agent traffic.",
+      "url": "https://raw.githubusercontent.com/stellar/stellar-dev-skill/v1.2.0/skills/agentic-payments/SKILL.md",
+      "digest": "sha256:b5e2d4def2242b684e3bb75a0945808fd4dbf7beb47a34afb8f17b553ee9accd"
+    },
+    {
+      "name": "assets",
+      "type": "skill-md",
+      "description": "Stellar Assets (classic) + trustlines + Stellar Asset Contract (SAC) bridge to smart contracts. Covers asset issuance, distribution, authorization flags, clawback, regulated assets, trustline management, and the SAC interop layer that exposes classic assets as SEP-41 contract tokens. Use when tokenizing real-world assets, issuing stablecoins, managing trustlines, or bridging classic assets to smart contracts.",
+      "url": "https://raw.githubusercontent.com/stellar/stellar-dev-skill/v1.2.0/skills/assets/SKILL.md",
+      "digest": "sha256:8ea19310a053edc0c2856f41908d7923f004538d31c211d287827c3beeb0c8e4"
+    },
+    {
+      "name": "dapp",
+      "type": "skill-md",
+      "description": "Stellar dApp / frontend development. Covers the JavaScript stellar-sdk (browser + Node.js), Freighter wallet, Stellar Wallets Kit (multi-wallet), Wallet Standard, smart accounts with passkeys, transaction building / signing / submission, smart contract invocation from the client, simulation, and error handling. Use when building a React/Next.js/Node.js app that talks to Stellar — classic operations or smart contracts.",
+      "url": "https://raw.githubusercontent.com/stellar/stellar-dev-skill/v1.2.0/skills/dapp/SKILL.md",
+      "digest": "sha256:1c5c5452595216c6f90bf796f1ed86854900e328931bfc930bc1f85367531c04"
+    },
+    {
+      "name": "data",
+      "type": "skill-md",
+      "description": "Querying Stellar chain data via Stellar RPC (preferred) and Horizon (legacy). Covers RPC JSON-RPC methods, Horizon REST endpoints, streaming, pagination, historical queries, Hubble/Galexie for deep history, and the RPC/Horizon migration story. Use when reading balances, transactions, operations, ledgers, contract events, or building any indexer/analytics workflow.",
+      "url": "https://raw.githubusercontent.com/stellar/stellar-dev-skill/v1.2.0/skills/data/SKILL.md",
+      "digest": "sha256:6c2b2da5cd9d3e1cf527b0278f50d4488359bb2ceea823e934c89f14adeef641"
+    },
+    {
+      "name": "smart-contracts",
+      "type": "archive",
+      "description": "Stellar smart contract development (Rust, soroban-sdk). Entry point with project setup, contract anatomy, and build/deploy workflow, routing to three companion files in this directory — development.md (storage, auth, cross-contract calls, events, errors, upgrades, factories, troubleshooting), testing.md (unit, fuzz, property, fork, mutation, integration), and security.md (vulnerability classes, checklists, tooling, audits). Use when writing, testing, securing, or shipping Stellar smart contracts (formerly branded Soroban).",
+      "url": "https://github.com/stellar/stellar-dev-skill/releases/download/v1.2.0/smart-contracts.tar.gz",
+      "digest": "sha256:d3f997c11e09043be025f2768918cc0d989e463e5fb652798ed1050ffc804b06"
+    },
+    {
+      "name": "standards",
+      "type": "skill-md",
+      "description": "Stellar standards, ecosystem, and reference. Covers SEPs (Stellar Ecosystem Proposals), CAPs (Core Advancement Proposals), and a quick map for picking the right standard for wallets, anchors, payments, deposits/withdrawals, federation, deep links, and KYC. Also bundles ecosystem references (DeFi protocols, dev tools, wallets, infra, community projects) and curated documentation links. Use when you need to know which SEP applies, or want a starting point for ecosystem integrations and official docs.",
+      "url": "https://raw.githubusercontent.com/stellar/stellar-dev-skill/v1.2.0/skills/standards/SKILL.md",
+      "digest": "sha256:7a3dbb58ade371a9b7114ac6aedb2b8ceec00a2032ea3e4382f53016d38a28e1"
+    },
+    {
+      "name": "zk-proofs",
+      "type": "skill-md",
+      "description": "Zero-knowledge proofs and privacy patterns on Stellar. Covers Groth16 verification in smart contracts via BLS12-381 host functions (CAP-0059, available), the BN254 + Poseidon proposals (CAP-0074/0075, status-sensitive), and concrete toolchain walkthroughs for Circom (on-chain verifiable today), Noir, and RISC Zero (attestation pattern until BN254 lands). Use when building privacy-preserving applications, ZK-verifier contracts, or wiring a proving toolchain to Stellar.",
+      "url": "https://raw.githubusercontent.com/stellar/stellar-dev-skill/v1.2.0/skills/zk-proofs/SKILL.md",
+      "digest": "sha256:44e992a294103cf0c0dafe35861c5b8bbc6bc0b99e5b41ee0bf560d40d601e20"
+    }
+  ]
+}

static/.well-known/api-catalog

@@ -0,0 +1,46 @@
+{
+  "linkset": [
+    {
+      "anchor": "https://developers.stellar.org/docs/data/apis/rpc",
+      "service-desc": [
+        {
+          "href": "https://developers.stellar.org/stellar-rpc.openrpc.json",
+          "type": "application/json"
+        }
+      ],
+      "service-doc": [
+        {
+          "href": "https://developers.stellar.org/docs/data/apis/rpc/api-reference",
+          "type": "text/html"
+        }
+      ]
+    },
+    {
+      "anchor": "https://developers.stellar.org/docs/data/apis/horizon",
+      "service-doc": [
+        {
+          "href": "https://developers.stellar.org/docs/data/apis/horizon/api-reference",
+          "type": "text/html"
+        }
+      ]
+    },
+    {
+      "anchor": "https://developers.stellar.org/docs/platforms/anchor-platform",
+      "service-doc": [
+        {
+          "href": "https://developers.stellar.org/docs/platforms/anchor-platform/api-reference",
+          "type": "text/html"
+        }
+      ]
+    },
+    {
+      "anchor": "https://developers.stellar.org/docs/platforms/stellar-disbursement-platform",
+      "service-doc": [
+        {
+          "href": "https://developers.stellar.org/docs/platforms/stellar-disbursement-platform/api-reference",
+          "type": "text/html"
+        }
+      ]
+    }
+  ]
+}