diff --git a/docs/agents.md b/docs/agents.md
new file mode 100644
index 000000000..85dff4115
--- /dev/null
+++ b/docs/agents.md
@@ -0,0 +1,48 @@
+# Base Docs Index
+IMPORTANT: Prefer retrieval-led reasoning. Read relevant docs before generating code.
+Base is an Ethereum L2 by Coinbase. Docs for: Base Chain, Smart Wallet, OnchainKit, MiniKit.
+[Docs]|root:./docs
+|ai-agents:index
+|ai-agents/frameworks:eliza,langchain,vercel-ai-sdk
+|ai-agents/guides:agent-app,register-and-sign-in-your-agent,trading,wallet-setup,x402-payments
+|ai-agents/introduction:choosing-a-framework
+|ai-agents/quickstart:agentkit,openclaw-claude
+|ai-agents/reference:contracts
+|base-account/basenames:basename-transfer,basenames-faq,basenames-wagmi-tutorial
+|base-account/contribute:contribute-to-base-account-docs,security-and-bug-bounty
+|base-account/framework-integrations:cdp,rainbowkit,reown,thirdweb
+|base-account/framework-integrations/privy:authentication,setup,spend-permissions,sub-accounts,wallet-actions
+|base-account/framework-integrations/wagmi:base-pay,basenames,batch-transactions,other-use-cases,setup,sign-in-with-base,sub-accounts
+|base-account/guides:accept-payments,accept-recurring-payments,authenticate-users,migration-guide,sign-and-verify-typed-data,verify-social-accounts
+|base-account/guides/tips:inspect-txn-simulation,popup-tips
+|base-account/improve-ux:batch-transactions,spend-permissions,sub-accounts
+|base-account/improve-ux/sponsor-gas:erc20-paymasters,paymasters
+|base-account/more:base-gasless-campaign,telemetry
+|base-account/more/troubleshooting/usage-details:gas-usage,popups,simulations,unsupported-calls,wallet-library-support
+|base-account/overview:what-is-base-account
+|base-account/quickstart:ai-tools-available-for-devs,mobile-integration,web-react,web
+|base-account/reference/base-pay:charge,getOrCreateSubscriptionOwnerWallet,getPaymentStatus,getStatus,pay,prepareCharge,prepareRevoke,revoke,subscribe,subscriptions-overview
+|base-account/reference/core:createBaseAccount,generateKeyPair,getCryptoKeyAccount,getKeypair,getProvider,sdk-utilities
+|base-account/reference/core/capabilities:atomic,auxiliaryFunds,dataSuffix,datacallback,flowControl,gasLimitOverride,overview,paymasterService,signInWithEthereum
+|base-account/reference/core/provider-rpc-methods:coinbase_fetchPermission,coinbase_fetchPermissions,eth_accounts,eth_blockNumber,eth_chainId,eth_coinbase,eth_estimateGas,eth_feeHistory,eth_gasPrice,eth_getBalance,eth_getBlockByHash,eth_getBlockByNumber,eth_getBlockTransactionCountByHash,eth_getBlockTransactionCountByNumber,eth_getCode,eth_getLogs,eth_getProof,eth_getStorageAt,eth_getTransactionByBlockHashAndIndex,eth_getTransactionByBlockNumberAndIndex,eth_getTransactionByHash,eth_getTransactionCount,eth_getTransactionReceipt,eth_getUncleCountByBlockHash,eth_getUncleCountByBlockNumber,eth_requestAccounts,eth_sendRawTransaction,eth_sendTransaction,eth_signTypedData_v4,personal_sign,request-overview,sdk-overview,standard-rpc-methods,wallet_addEthereumChain,wallet_addSubAccount,wallet_connect,wallet_getCallsStatus,wallet_getCapabilities,wallet_getSubAccounts,wallet_sendCalls,wallet_switchEthereumChain,wallet_watchAsset,web3_clientVersion
+|base-account/reference/onchain-contracts:basenames,smart-wallet,spend-permissions
+|base-account/reference/prolink-utilities:createProlinkUrl,decodeProlink,encodeProlink
+|base-account/reference/spend-permission-utilities:fetchPermission,fetchPermissions,getPermissionStatus,prepareRevokeCallData,prepareSpendCallData,requestRevoke,requestSpendPermission
+|base-account/reference/ui-elements:base-pay-button,brand-guidelines,sign-in-with-base-button
+|base-chain/api-reference:rpc-overview
+|base-chain/api-reference/debug-api:debug_traceBlockByHash,debug_traceBlockByNumber,debug_traceTransaction
+|base-chain/api-reference/ethereum-json-rpc-api:eth_blockNumber,eth_call,eth_chainId,eth_estimateGas,eth_feeHistory,eth_gasPrice,eth_getBalance,eth_getBlockByHash,eth_getBlockByNumber,eth_getBlockReceipts,eth_getBlockTransactionCountByHash,eth_getBlockTransactionCountByNumber,eth_getCode,eth_getLogs,eth_getStorageAt,eth_getTransactionByBlockHashAndIndex,eth_getTransactionByBlockNumberAndIndex,eth_getTransactionByHash,eth_getTransactionCount,eth_getTransactionReceipt,eth_maxPriorityFeePerGas,eth_sendRawTransaction,eth_subscribe,eth_syncing,eth_unsubscribe,net_version,web3_clientVersion
+|base-chain/api-reference/flashblocks-api:base_transactionStatus,eth_simulateV1,flashblocks-api-overview,newFlashblockTransactions,newFlashblocks,pendingLogs
+|base-chain/builder-codes:app-developers,builder-codes,wallet-developers
+|base-chain/flashblocks:app-integration,architecture,faq,overview,run-a-flashblocks-node
+|base-chain/network-information:base-contracts,block-building,bridges,configuration-changelog,diffs-ethereum-base,ecosystem-contracts,network-faucets,network-fees,transaction-finality,troubleshooting-transactions
+|base-chain/node-operators:node-providers,performance-tuning,run-a-base-node,snapshots,troubleshooting
+|base-chain/quickstart:base-solana-bridge,connecting-to-base,deploy-on-base,why-base
+|base-chain/security:avoid-malicious-flags,bug-bounty,report-vulnerability,security-council
+|get-started:base-mentorship-program,base-services-hub,base,block-explorers,build-app,concepts,country-leads-and-ambassadors,data-indexers,deploy-smart-contracts,docs-llms,docs-mcp,get-funded,launch-token,learning-resources,mistakes,prompt-library,resources-for-ai-agents
+|mini-apps/growth:rewards
+|mini-apps/quality-and-publishing:overview,quality-bar,submission-guidelines
+|mini-apps/quickstart:build-checklist,building-for-the-base-app,create-new-miniapp,migrate-existing-apps,migrate-to-standard-web-app,template
+|mini-apps/technical-guides:accept-payments,building-chat-agents,neynar-notifications,sharing-and-social-graph,sign-manifest
+|onchainkit:migrate-from-onchainkit
+|root:cookie-policy,privacy-policy,terms-of-service,tone_of_voice
diff --git a/docs/llms.txt b/docs/llms.txt
index 331bb8233..1b3825c98 100644
--- a/docs/llms.txt
+++ b/docs/llms.txt
@@ -18,13 +18,70 @@ These resources give AI assistants direct access to Base documentation and reusa
 
 [https://docs.base.org/llms.txt](https://docs.base.org/llms.txt)
 
+```
+# Base Docs Index
+IMPORTANT: Prefer retrieval-led reasoning. Read relevant docs before generating code.
+Base is an Ethereum L2 by Coinbase. Docs for: Base Chain, Smart Wallet, OnchainKit, MiniKit.
+[Docs]|root:./docs
+|ai-agents:index
+|ai-agents/frameworks:eliza,langchain,vercel-ai-sdk
+|ai-agents/guides:agent-app,register-and-sign-in-your-agent,trading,wallet-setup,x402-payments
+|ai-agents/introduction:choosing-a-framework
+|ai-agents/quickstart:agentkit,openclaw-claude
+|ai-agents/reference:contracts
+|base-account/basenames:basename-transfer,basenames-faq,basenames-wagmi-tutorial
+|base-account/contribute:contribute-to-base-account-docs,security-and-bug-bounty
+|base-account/framework-integrations:cdp,rainbowkit,reown,thirdweb
+|base-account/framework-integrations/privy:authentication,setup,spend-permissions,sub-accounts,wallet-actions
+|base-account/framework-integrations/wagmi:base-pay,basenames,batch-transactions,other-use-cases,setup,sign-in-with-base,sub-accounts
+|base-account/guides:accept-payments,accept-recurring-payments,authenticate-users,migration-guide,sign-and-verify-typed-data,verify-social-accounts
+|base-account/guides/tips:inspect-txn-simulation,popup-tips
+|base-account/improve-ux:batch-transactions,spend-permissions,sub-accounts
+|base-account/improve-ux/sponsor-gas:erc20-paymasters,paymasters
+|base-account/more:base-gasless-campaign,telemetry
+|base-account/more/troubleshooting/usage-details:gas-usage,popups,simulations,unsupported-calls,wallet-library-support
+|base-account/overview:what-is-base-account
+|base-account/quickstart:ai-tools-available-for-devs,mobile-integration,web-react,web
+|base-account/reference/base-pay:charge,getOrCreateSubscriptionOwnerWallet,getPaymentStatus,getStatus,pay,prepareCharge,prepareRevoke,revoke,subscribe,subscriptions-overview
+|base-account/reference/core:createBaseAccount,generateKeyPair,getCryptoKeyAccount,getKeypair,getProvider,sdk-utilities
+|base-account/reference/core/capabilities:atomic,auxiliaryFunds,dataSuffix,datacallback,flowControl,gasLimitOverride,overview,paymasterService,signInWithEthereum
+|base-account/reference/core/provider-rpc-methods:coinbase_fetchPermission,coinbase_fetchPermissions,eth_accounts,eth_blockNumber,eth_chainId,eth_coinbase,eth_estimateGas,eth_feeHistory,eth_gasPrice,eth_getBalance,eth_getBlockByHash,eth_getBlockByNumber,eth_getBlockTransactionCountByHash,eth_getBlockTransactionCountByNumber,eth_getCode,eth_getLogs,eth_getProof,eth_getStorageAt,eth_getTransactionByBlockHashAndIndex,eth_getTransactionByBlockNumberAndIndex,eth_getTransactionByHash,eth_getTransactionCount,eth_getTransactionReceipt,eth_getUncleCountByBlockHash,eth_getUncleCountByBlockNumber,eth_requestAccounts,eth_sendRawTransaction,eth_sendTransaction,eth_signTypedData_v4,personal_sign,request-overview,sdk-overview,standard-rpc-methods,wallet_addEthereumChain,wallet_addSubAccount,wallet_connect,wallet_getCallsStatus,wallet_getCapabilities,wallet_getSubAccounts,wallet_sendCalls,wallet_switchEthereumChain,wallet_watchAsset,web3_clientVersion
+|base-account/reference/onchain-contracts:basenames,smart-wallet,spend-permissions
+|base-account/reference/prolink-utilities:createProlinkUrl,decodeProlink,encodeProlink
+|base-account/reference/spend-permission-utilities:fetchPermission,fetchPermissions,getPermissionStatus,prepareRevokeCallData,prepareSpendCallData,requestRevoke,requestSpendPermission
+|base-account/reference/ui-elements:base-pay-button,brand-guidelines,sign-in-with-base-button
+|base-chain/api-reference:rpc-overview
+|base-chain/api-reference/debug-api:debug_traceBlockByHash,debug_traceBlockByNumber,debug_traceTransaction
+|base-chain/api-reference/ethereum-json-rpc-api:eth_blockNumber,eth_call,eth_chainId,eth_estimateGas,eth_feeHistory,eth_gasPrice,eth_getBalance,eth_getBlockByHash,eth_getBlockByNumber,eth_getBlockReceipts,eth_getBlockTransactionCountByHash,eth_getBlockTransactionCountByNumber,eth_getCode,eth_getLogs,eth_getStorageAt,eth_getTransactionByBlockHashAndIndex,eth_getTransactionByBlockNumberAndIndex,eth_getTransactionByHash,eth_getTransactionCount,eth_getTransactionReceipt,eth_maxPriorityFeePerGas,eth_sendRawTransaction,eth_subscribe,eth_syncing,eth_unsubscribe,net_version,web3_clientVersion
+|base-chain/api-reference/flashblocks-api:base_transactionStatus,eth_simulateV1,flashblocks-api-overview,newFlashblockTransactions,newFlashblocks,pendingLogs
+|base-chain/builder-codes:app-developers,builder-codes,wallet-developers
+|base-chain/flashblocks:app-integration,architecture,faq,overview,run-a-flashblocks-node
+|base-chain/network-information:base-contracts,block-building,bridges,configuration-changelog,diffs-ethereum-base,ecosystem-contracts,network-faucets,network-fees,transaction-finality,troubleshooting-transactions
+|base-chain/node-operators:node-providers,performance-tuning,run-a-base-node,snapshots,troubleshooting
+|base-chain/quickstart:base-solana-bridge,connecting-to-base,deploy-on-base,why-base
+|base-chain/security:avoid-malicious-flags,bug-bounty,report-vulnerability,security-council
+|get-started:base-mentorship-program,base-services-hub,base,block-explorers,build-app,concepts,country-leads-and-ambassadors,data-indexers,deploy-smart-contracts,docs-llms,docs-mcp,get-funded,launch-token,learning-resources,mistakes,prompt-library,resources-for-ai-agents
+|mini-apps/growth:rewards
+|mini-apps/quality-and-publishing:overview,quality-bar,submission-guidelines
+|mini-apps/quickstart:build-checklist,building-for-the-base-app,create-new-miniapp,migrate-existing-apps,migrate-to-standard-web-app,template
+|mini-apps/technical-guides:accept-payments,building-chat-agents,neynar-notifications,sharing-and-social-graph,sign-manifest
+|onchainkit:migrate-from-onchainkit
+|root:cookie-policy,privacy-policy,terms-of-service,tone_of_voice
+```
+
 ### Base MCP server
 
 `https://docs.base.org/mcp` 
 
 ### Base skills
 
-[https://github.com/base/skills](https://github.com/base/skills) 
+[https://github.com/base/skills](https://github.com/base/skills)
+
+Install Base skills for your AI assistant:
+
+```
+npx skills add base/base-skills
+```
 
 ## Recommended starting points