{
  "schema_version": "1.1.0",
  "version": "1.1.0",
  "current_sdk_version": "6.0.0",
  "generated": "2026-05-15T00:00:00.000Z",
  "description": "Domain-scoped skill files mapping high-level developer intents to required packages, entry points, workflows, and examples. Load the skill file for your context before exploring workflows or examples.",
  "schema_notes": {
    "v1_1_0": "Added optional fields for external skills hosted on first-party product subdomains (e.g. PUSD on pusd.push.org). New optional fields: 'external' (boolean), 'host' (string, e.g. 'pusd.push.org'), 'agent_layer' (string, URL of the external skill's full llms.txt), 'repo' (string, GitHub repo URL). Internal skills (push-frontend / push-backend / push-contracts) omit these fields. Treat external skills like any other skill at load time; the agent fetches them from their canonical host."
  },
  "skills": [
    {
      "id": "push-frontend",
      "name": "push-frontend",
      "description": "Use when building React apps with @pushchain/ui-kit — covers PushUniversalWalletProvider setup, PushUniversalAccountButton, usePushChainClient hook, theme customization, and sending universal transactions (Route 1/2/3) from the browser. Triggers on: 'add wallet connect button in React', 'use @pushchain/ui-kit in Next.js or Vite', 'send universal transaction from browser', 'customize PushUniversalWalletProvider theme'.",
      "file": "agents/skills/push-frontend/SKILL.md",
      "url": "https://push.org/agents/skills/push-frontend/SKILL.md",
      "intent": "Enable universal transactions in a React frontend app",
      "package": "@pushchain/ui-kit",
      "entry": "usePushChainClient()",
      "quickstart": "npx create-universal-dapp",
      "references": ["agents/skills/push-frontend/references/ui-components.md"],
      "resources": "agents/resources/push-frontend/index.json"
    },
    {
      "id": "push-backend",
      "name": "push-backend",
      "description": "Use when writing Node.js scripts, bots, or server-side code with @pushchain/core — covers PushChain.initialize, wrapping ethers/viem/Solana keypairs into a UniversalSigner, all three routes, multichain cascades, transaction tracking, and utility functions. Not for browser or React code. Triggers on: 'initialize PushChain client in Node.js', 'send transaction from backend script', 'wrap ethers signer with toUniversal', 'track transaction by hash'.",
      "file": "agents/skills/push-backend/SKILL.md",
      "url": "https://push.org/agents/skills/push-backend/SKILL.md",
      "intent": "Execute universal transactions from Node.js, scripts, bots, or automation",
      "package": "@pushchain/core",
      "entry": "PushChain.initialize(signer)",
      "resources": "agents/resources/push-backend/index.json",
      "references": [
        "agents/skills/push-backend/references/signer-options.md",
        "agents/skills/push-backend/references/send-universal-transaction.md"
      ]
    },
    {
      "id": "push-contracts",
      "name": "push-contracts",
      "description": "Use when writing Solidity contracts deployed on Push Chain — covers IUEAFactory for identifying cross-chain callers (UEA), IUniversalGatewayPC (UGPC) for dispatching outbound cross-chain transactions, executeUniversalTx inbound callbacks, UniversalCore oracle reads, and Foundry/Hardhat deployment. No SDK inside .sol files. Triggers on: 'identify cross-chain caller in Solidity', 'dispatch outbound tx from Push Chain contract', 'implement executeUniversalTx callback', 'deploy Solidity contract with Foundry on Push Chain'.",
      "file": "agents/skills/push-contracts/SKILL.md",
      "url": "https://push.org/agents/skills/push-contracts/SKILL.md",
      "intent": "Write Solidity contracts on Push Chain: identify cross-chain callers via UEAFactory, dispatch outbound txs via UGPC, receive inbound callbacks, read gas prices via UniversalCore",
      "package": "none (pure Solidity — no SDK required inside contracts)",
      "entry": "IUniversalGatewayPC(UGPC).sendUniversalTxOutbound(...)",
      "references": [
        "agents/skills/push-contracts/references/contract-interfaces.md"
      ],
      "scripts": ["agents/skills/push-contracts/scripts/deploy.sh"],
      "resources": "agents/resources/push-contracts/index.json"
    },
    {
      "id": "push-pusd",
      "name": "push-pusd",
      "external": true,
      "host": "pusd.push.org",
      "description": "Use when integrating PUSD or PUSD+ on Push Chain — covers minting (deposit USDC/USDT, both Path A external-chain multicall and Path B native Push EOA two-signature flows), redemption routing (preferred asset / basket / emergency proportional drain), PUSD+ NAV quoting via previewMintPlus / previewBurnPlus, three-tier PUSD+ redemption (instant / convert / queue), and cross-chain deposits via prepareTransaction + executeTransactions. Hosted on pusd.push.org and not duplicated in this repo. Triggers on: 'mint PUSD', 'redeem PUSD+', 'quote PUSD+ NAV', 'PUSDManager deposit', 'integrate Push Chain stablecoin'.",
      "url": "https://pusd.push.org/agents/skill/push-pusd/SKILL.md",
      "agent_layer": "https://pusd.push.org/llms.txt",
      "repo": "https://github.com/pushchain/push-chain-pusd",
      "intent": "Mint and redeem PUSD / PUSD+ across frontend, backend, and on-chain contexts on Push Chain Donut Testnet",
      "package": "@pushchain/ui-kit (frontend) | @pushchain/core (backend) | Solidity ^0.8.20 (on-chain)",
      "entry": "PUSDManager.deposit / PUSDManager.depositToPlus"
    }
  ]
}