{
  "schemaVersion": "1.0",
  "item": {
    "slug": "philidor",
    "name": "Philidor — DeFi Vault Intelligence",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/zkoranges/philidor",
    "canonicalUrl": "https://clawhub.ai/zkoranges/philidor",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/philidor",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=philidor",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "package.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/philidor"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/philidor",
    "agentPageUrl": "https://openagent3.xyz/skills/philidor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/philidor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/philidor/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Philidor — DeFi Vault Intelligence",
        "body": "Institutional-grade risk scores, yield comparison, portfolio analysis, and oracle monitoring for DeFi vaults across five major protocols and six chains."
      },
      {
        "title": "Quick Start",
        "body": "# Platform overview — total TVL, vault counts, risk distribution\nphilidor stats\n\n# Search vaults by name, symbol, or asset\nphilidor search \"USDC\"\n\n# Analyze all DeFi positions for a wallet address\nphilidor portfolio 0xYourWalletAddress"
      },
      {
        "title": "Risk Tiers",
        "body": "Every vault receives a composite risk score from 0 to 10, grouped into three tiers:\n\nTierScore RangeMeaningPrime8.0 - 10.0Institutional-grade. Battle-tested protocols, blue-chip assets, strong governance controls.Core5.0 - 7.9Solid fundamentals with some trade-offs in asset quality, audit coverage, or decentralisation.Edge0.0 - 4.9Higher risk. Newer protocols, exotic assets, weaker control structures, or recent incidents.UnratedN/AInsufficient data to score. Treated as high-risk by default.\n\nScores are derived from three weighted vectors:\n\nAsset Quality (40%) — collateral quality, oracle reliability, liquidity depth, peg stability\nPlatform & Strategy (40%) — smart contract maturity, audit coverage, TVL track record, incident history\nControl & Governance (20%) — timelock presence, multisig configuration, upgradeability, admin powers"
      },
      {
        "title": "APR (Annual Percentage Rate)",
        "body": "APR values are stored as decimals: 0.05 means 5%.\n\napr_net — total APR including base yield plus any incentive rewards\nbase_apr — native protocol yield only (lending rate, share price accrual), before rewards\nInvariant: apr_net = base_apr + SUM(reward APRs)\n\nReward types include token_incentive (MORPHO, ARB, SPK), points, trading_fee (LP fees), and strategy (Yearn sub-strategies)."
      },
      {
        "title": "Protocols",
        "body": "ProtocolDescriptionMorphoOptimised lending with curated vaults (Ethereum, Base)Yearn v3Automated yield strategies (Ethereum, Polygon, Arbitrum, Base, Optimism)Aave v3Blue-chip lending/borrowing (Ethereum, Polygon, Arbitrum, Avalanche, Optimism, Base)BeefyMulti-chain yield optimiser (12+ chains)SparkMakerDAO lending markets (Ethereum)"
      },
      {
        "title": "Chains",
        "body": "Ethereum, Base, Arbitrum, Polygon, Optimism, and Avalanche."
      },
      {
        "title": "Discovery & Search",
        "body": "# List vaults with filters\nphilidor vaults\nphilidor vaults --chain ethereum\nphilidor vaults --protocol morpho\nphilidor vaults --risk-tier prime\nphilidor vaults --asset USDC\nphilidor vaults --min-tvl 1000000\nphilidor vaults --stablecoin --audited\nphilidor vaults --high-confidence             # Only vaults with high data confidence\nphilidor vaults --no-il                       # Exclude vaults with impermanent loss risk\nphilidor vaults --sort apr_net:desc --limit 10 --page 2\n\n# Search vaults by name, protocol, asset, or address\nphilidor search \"USDC\"\nphilidor search \"Aave\"\nphilidor search \"Gauntlet\"\nphilidor search \"USDC\" --limit 20             # Control result count (default: 10)\n\n# For filtered queries, use `vaults` with flags instead of search:\nphilidor vaults --asset USDC --chain base --risk-tier prime\nphilidor vaults --asset WETH --protocol morpho --sort apr_net:desc"
      },
      {
        "title": "Vault Detail",
        "body": "# By vault ID\nphilidor vault <vault-id>\n\n# By network slug + contract address\nphilidor vault ethereum 0x1234...\n\n# Sub-resources (require network + address form)\nphilidor vault ethereum 0x1234... --events       # Event history (incidents, parameter changes)\nphilidor vault ethereum 0x1234... --markets      # Morpho market allocations\nphilidor vault ethereum 0x1234... --strategies   # Yearn strategies\nphilidor vault ethereum 0x1234... --rewards      # Reward breakdown (base + incentives)"
      },
      {
        "title": "Portfolio",
        "body": "# All positions across all chains\nphilidor portfolio 0xWalletAddress\n\n# Filter to a specific chain\nphilidor portfolio 0xWalletAddress --chain base\n\nReturns: vault details, chain, balance in USD, APR, risk score, risk tier for each position. Includes aggregates: total value, weighted risk, position count, risk distribution."
      },
      {
        "title": "Comparison & Risk",
        "body": "# Side-by-side vault comparison (2-5 vault IDs)\nphilidor compare <vault-id-1> <vault-id-2> <vault-id-3>\n\n# Detailed risk vector breakdown for a specific vault\nphilidor risk breakdown <vault-id>\nphilidor risk breakdown ethereum 0x1234...\n\n# Explain the risk scoring methodology — tiers, vectors, weights\nphilidor risk explain\n\n# Vaults with recent critical security incidents\nphilidor risk incidents"
      },
      {
        "title": "Reference Data",
        "body": "# List all supported protocols with vault counts and TVL\nphilidor protocols\n\n# Protocol detail — audit status, chain coverage, incident history\nphilidor protocol <id>\n\n# List curators (Morpho vault managers)\nphilidor curators\nphilidor curators --sort tvl_total:desc --limit 10 --page 1\n\n# Curator detail — managed vaults, TVL, performance\nphilidor curator <id>\n\n# Platform overview — total TVL, vault counts, risk distribution\nphilidor stats\n\n# Supported chains\nphilidor chains\n\n# Supported assets\nphilidor assets\n\n# Oracle feed freshness and deviation data\nphilidor oracles freshness"
      },
      {
        "title": "Output Formats",
        "body": "All commands support three output formats:\n\nphilidor vaults --json       # Structured JSON (best for agents and scripting)\nphilidor vaults --table      # Human-readable table (default in TTY)\nphilidor vaults --csv        # CSV for spreadsheets and data pipelines\n\nWhen output is piped (non-TTY), JSON is the default. Use --json explicitly in agent workflows for consistency.\n\nAdditional global flags:\n\n--api-url <url>              # Override API base URL (default: https://api.philidor.io)\n                             # Also respects PHILIDOR_API_URL environment variable"
      },
      {
        "title": "Workflow 1: Find the Best Vault for a User's Needs",
        "body": "Step-by-step pattern for recommending a vault based on user criteria.\n\n# Step 1: Search for matching vaults\nphilidor search \"stablecoin vault on base\" --json\n# Returns matched vaults with TVL, APR, risk tier\n\n# Step 2: Compare the top candidates side-by-side\nphilidor compare <vault-id-1> <vault-id-2> <vault-id-3> --json\n# Compares TVL, APR (base + rewards), risk score, audited status, curator\n\n# Step 3: Deep-dive into the risk profile of the chosen vault\nphilidor risk breakdown <chosen-vault-id> --json\n# Full risk vector breakdown:\n#   - Asset risk (collateral quality, oracle reliability, liquidity depth)\n#   - Platform risk (smart contract maturity, audit coverage, incident history)\n#   - Control risk (governance, timelock, upgradeability, admin powers)\n\n# Step 4: Check recent events for any red flags\nphilidor vault <network> <address> --events --json\n# Recent events: incidents, parameter changes, pauses\n\n# Decision: Recommend the vault with the best risk-adjusted yield.\n# Flag any Edge-tier vaults or recent incidents to the user."
      },
      {
        "title": "Workflow 2: Compare Protocols for Yield Farming",
        "body": "Step-by-step pattern for cross-protocol yield comparison.\n\n# Step 1: Get protocol overview\nphilidor protocols --json\n# Lists all protocols with vault counts, TVL, risk distribution\n\n# Step 2: Get top vaults per protocol (can run in parallel)\nphilidor vaults --protocol morpho --sort apr_net:desc --limit 5 --json\nphilidor vaults --protocol aave-v3 --sort apr_net:desc --limit 5 --json\nphilidor vaults --protocol yearn-v3 --sort apr_net:desc --limit 5 --json\n# Top 5 vaults per protocol ranked by yield\n\n# Step 3: Compare the best vaults across protocols\nphilidor compare <best-morpho-id> <best-aave-id> <best-yearn-id> --json\n# Cross-protocol comparison for the same asset class\n\n# Step 4: Get protocol-level details\nphilidor protocol morpho --json\n# Protocol detail: audit status, versions, incident history, chain coverage\n\n# Decision: Compare yield vs risk across protocols.\n# Note audited vs unaudited versions and flag incident history."
      },
      {
        "title": "Workflow 3: Analyze Portfolio Risk",
        "body": "Step-by-step pattern for assessing and improving a wallet's DeFi risk profile.\n\n# Step 1: Get all positions\nphilidor portfolio 0xWalletAddress --json\n# All positions: vault, chain, balance_usd, APR, risk_score, risk_tier\n# Aggregates: total value, weighted risk, position count, risk distribution\n\n# Step 2: Identify risky positions\n# Filter results for positions with risk_tier = \"Edge\" or risk_score < 5\n\n# Step 3: Investigate each risky position\nphilidor risk breakdown <risky-vault-id> --json\n# What is driving the low score? Asset? Platform? Control?\n\n# Step 4: Find safer alternatives for the same asset\nphilidor search \"USDC prime audited\" --json\n# Or use:\nphilidor vaults --asset USDC --risk-tier prime --audited --json\n# Find Prime-tier alternatives for the same asset\n\n# Decision: Present a portfolio risk summary to the user.\n# Highlight Edge-tier positions and suggest Prime alternatives\n# with comparable or better yield."
      },
      {
        "title": "Workflow 4: Monitor Vault Safety",
        "body": "Step-by-step pattern for ongoing safety monitoring.\n\n# Step 1: Check for active incidents across all protocols\nphilidor risk incidents --json\n# Vaults with recent critical incidents\n\n# Step 2: Check oracle health\nphilidor oracles freshness --json\n# Oracle feed freshness: stale feeds, deviation alerts\n\n# Step 3: Check event history for a specific vault\nphilidor vault <network> <address> --events --json\n# Event timeline: incidents, parameter changes, pauses\n\n# Decision: Flag vaults with active incidents or stale oracle feeds.\n# Recommend pausing deposits until issues are resolved."
      },
      {
        "title": "Interpreting Output",
        "body": "Key fields and their formats:\n\nFieldFormatExampleNotesapr_netDecimal0.0523Total APR = 5.23%. Includes base yield + rewards.base_aprDecimal0.0340Base yield only = 3.40%. Native protocol rate before incentives.tvl_usdNumber (string)\"12500000.50\"Total value locked in USD. Returned as string for precision.total_scoreNumber or null8.3Composite risk score 0-10. Null means unrated.risk_tierString\"Prime\"Derived from total_score: Prime (>=8), Core (5-7.9), Edge (<5).risk_vectorsObject{\"asset\":{\"score\":8.5},...}Breakdown: asset (40%), platform (40%), control (20%).is_auditedBooleantrueWhether the protocol version has been audited.last_synced_atISO 8601\"2026-02-26T12:00:00Z\"When the vault data was last refreshed from on-chain.rewardsArray[{\"token_symbol\":\"MORPHO\",\"apr\":0.018}]Individual reward token APRs. Sum + base_apr = apr_net."
      },
      {
        "title": "Error Handling",
        "body": "ErrorCauseFixConnection refusedAPI server unreachableCheck network connectivity. Verify --api-url if using a custom endpoint. The default is https://api.philidor.io.404 Not FoundInvalid vault ID, protocol ID, or addressVerify the vault ID exists with philidor vaults. Check that the network slug is correct (e.g., ethereum, not eth).429 Too Many RequestsRate limit exceededWait and retry. The public API allows generous read limits but has per-IP throttling. Space out bulk queries.Request timeoutAPI response took too longRetry the request. For large result sets, use --limit to reduce page size.Invalid chainUnsupported chain slugRun philidor chains to see valid chain slugs."
      },
      {
        "title": "Best Practices",
        "body": "Always use --json in agent workflows. JSON output is structured, stable, and machine-parseable. Table output is for human consumption only and may change format between versions.\n\n\nCheck risk before recommending any vault. Never recommend a vault based on APR alone. Always run philidor risk breakdown <id> and check for Edge-tier scores or recent incidents via philidor risk incidents.\n\n\nNote data freshness timestamps. The last_synced_at field indicates when vault data was last refreshed from on-chain sources. Data older than a few hours may not reflect current APR or TVL. Flag stale data to users.\n\n\nCross-reference incidents and oracle health. Before recommending a vault, check philidor risk incidents for active security events and philidor oracles freshness for stale price feeds. These can materially affect vault safety.\n\n\nUse portfolio context for personalised advice. When a user has a wallet address, start with philidor portfolio <address> to understand their existing positions before suggesting new vaults. This enables risk-aware recommendations that consider concentration and diversification."
      },
      {
        "title": "Resources",
        "body": "Website: https://philidor.io\nAPI Documentation: https://api.philidor.io/v1/docs\nRisk Methodology: philidor risk explain or https://philidor.io/risk"
      }
    ],
    "body": "Philidor — DeFi Vault Intelligence\n\nInstitutional-grade risk scores, yield comparison, portfolio analysis, and oracle monitoring for DeFi vaults across five major protocols and six chains.\n\nQuick Start\n# Platform overview — total TVL, vault counts, risk distribution\nphilidor stats\n\n# Search vaults by name, symbol, or asset\nphilidor search \"USDC\"\n\n# Analyze all DeFi positions for a wallet address\nphilidor portfolio 0xYourWalletAddress\n\nCore Concepts\nRisk Tiers\n\nEvery vault receives a composite risk score from 0 to 10, grouped into three tiers:\n\nTier\tScore Range\tMeaning\nPrime\t8.0 - 10.0\tInstitutional-grade. Battle-tested protocols, blue-chip assets, strong governance controls.\nCore\t5.0 - 7.9\tSolid fundamentals with some trade-offs in asset quality, audit coverage, or decentralisation.\nEdge\t0.0 - 4.9\tHigher risk. Newer protocols, exotic assets, weaker control structures, or recent incidents.\nUnrated\tN/A\tInsufficient data to score. Treated as high-risk by default.\n\nScores are derived from three weighted vectors:\n\nAsset Quality (40%) — collateral quality, oracle reliability, liquidity depth, peg stability\nPlatform & Strategy (40%) — smart contract maturity, audit coverage, TVL track record, incident history\nControl & Governance (20%) — timelock presence, multisig configuration, upgradeability, admin powers\nAPR (Annual Percentage Rate)\n\nAPR values are stored as decimals: 0.05 means 5%.\n\napr_net — total APR including base yield plus any incentive rewards\nbase_apr — native protocol yield only (lending rate, share price accrual), before rewards\nInvariant: apr_net = base_apr + SUM(reward APRs)\n\nReward types include token_incentive (MORPHO, ARB, SPK), points, trading_fee (LP fees), and strategy (Yearn sub-strategies).\n\nProtocols\nProtocol\tDescription\nMorpho\tOptimised lending with curated vaults (Ethereum, Base)\nYearn v3\tAutomated yield strategies (Ethereum, Polygon, Arbitrum, Base, Optimism)\nAave v3\tBlue-chip lending/borrowing (Ethereum, Polygon, Arbitrum, Avalanche, Optimism, Base)\nBeefy\tMulti-chain yield optimiser (12+ chains)\nSpark\tMakerDAO lending markets (Ethereum)\nChains\n\nEthereum, Base, Arbitrum, Polygon, Optimism, and Avalanche.\n\nCommands\nDiscovery & Search\n# List vaults with filters\nphilidor vaults\nphilidor vaults --chain ethereum\nphilidor vaults --protocol morpho\nphilidor vaults --risk-tier prime\nphilidor vaults --asset USDC\nphilidor vaults --min-tvl 1000000\nphilidor vaults --stablecoin --audited\nphilidor vaults --high-confidence             # Only vaults with high data confidence\nphilidor vaults --no-il                       # Exclude vaults with impermanent loss risk\nphilidor vaults --sort apr_net:desc --limit 10 --page 2\n\n# Search vaults by name, protocol, asset, or address\nphilidor search \"USDC\"\nphilidor search \"Aave\"\nphilidor search \"Gauntlet\"\nphilidor search \"USDC\" --limit 20             # Control result count (default: 10)\n\n# For filtered queries, use `vaults` with flags instead of search:\nphilidor vaults --asset USDC --chain base --risk-tier prime\nphilidor vaults --asset WETH --protocol morpho --sort apr_net:desc\n\nVault Detail\n# By vault ID\nphilidor vault <vault-id>\n\n# By network slug + contract address\nphilidor vault ethereum 0x1234...\n\n# Sub-resources (require network + address form)\nphilidor vault ethereum 0x1234... --events       # Event history (incidents, parameter changes)\nphilidor vault ethereum 0x1234... --markets      # Morpho market allocations\nphilidor vault ethereum 0x1234... --strategies   # Yearn strategies\nphilidor vault ethereum 0x1234... --rewards      # Reward breakdown (base + incentives)\n\nPortfolio\n# All positions across all chains\nphilidor portfolio 0xWalletAddress\n\n# Filter to a specific chain\nphilidor portfolio 0xWalletAddress --chain base\n\n\nReturns: vault details, chain, balance in USD, APR, risk score, risk tier for each position. Includes aggregates: total value, weighted risk, position count, risk distribution.\n\nComparison & Risk\n# Side-by-side vault comparison (2-5 vault IDs)\nphilidor compare <vault-id-1> <vault-id-2> <vault-id-3>\n\n# Detailed risk vector breakdown for a specific vault\nphilidor risk breakdown <vault-id>\nphilidor risk breakdown ethereum 0x1234...\n\n# Explain the risk scoring methodology — tiers, vectors, weights\nphilidor risk explain\n\n# Vaults with recent critical security incidents\nphilidor risk incidents\n\nReference Data\n# List all supported protocols with vault counts and TVL\nphilidor protocols\n\n# Protocol detail — audit status, chain coverage, incident history\nphilidor protocol <id>\n\n# List curators (Morpho vault managers)\nphilidor curators\nphilidor curators --sort tvl_total:desc --limit 10 --page 1\n\n# Curator detail — managed vaults, TVL, performance\nphilidor curator <id>\n\n# Platform overview — total TVL, vault counts, risk distribution\nphilidor stats\n\n# Supported chains\nphilidor chains\n\n# Supported assets\nphilidor assets\n\n# Oracle feed freshness and deviation data\nphilidor oracles freshness\n\nOutput Formats\n\nAll commands support three output formats:\n\nphilidor vaults --json       # Structured JSON (best for agents and scripting)\nphilidor vaults --table      # Human-readable table (default in TTY)\nphilidor vaults --csv        # CSV for spreadsheets and data pipelines\n\n\nWhen output is piped (non-TTY), JSON is the default. Use --json explicitly in agent workflows for consistency.\n\nAdditional global flags:\n\n--api-url <url>              # Override API base URL (default: https://api.philidor.io)\n                             # Also respects PHILIDOR_API_URL environment variable\n\nAgent Workflows\nWorkflow 1: Find the Best Vault for a User's Needs\n\nStep-by-step pattern for recommending a vault based on user criteria.\n\n# Step 1: Search for matching vaults\nphilidor search \"stablecoin vault on base\" --json\n# Returns matched vaults with TVL, APR, risk tier\n\n# Step 2: Compare the top candidates side-by-side\nphilidor compare <vault-id-1> <vault-id-2> <vault-id-3> --json\n# Compares TVL, APR (base + rewards), risk score, audited status, curator\n\n# Step 3: Deep-dive into the risk profile of the chosen vault\nphilidor risk breakdown <chosen-vault-id> --json\n# Full risk vector breakdown:\n#   - Asset risk (collateral quality, oracle reliability, liquidity depth)\n#   - Platform risk (smart contract maturity, audit coverage, incident history)\n#   - Control risk (governance, timelock, upgradeability, admin powers)\n\n# Step 4: Check recent events for any red flags\nphilidor vault <network> <address> --events --json\n# Recent events: incidents, parameter changes, pauses\n\n# Decision: Recommend the vault with the best risk-adjusted yield.\n# Flag any Edge-tier vaults or recent incidents to the user.\n\nWorkflow 2: Compare Protocols for Yield Farming\n\nStep-by-step pattern for cross-protocol yield comparison.\n\n# Step 1: Get protocol overview\nphilidor protocols --json\n# Lists all protocols with vault counts, TVL, risk distribution\n\n# Step 2: Get top vaults per protocol (can run in parallel)\nphilidor vaults --protocol morpho --sort apr_net:desc --limit 5 --json\nphilidor vaults --protocol aave-v3 --sort apr_net:desc --limit 5 --json\nphilidor vaults --protocol yearn-v3 --sort apr_net:desc --limit 5 --json\n# Top 5 vaults per protocol ranked by yield\n\n# Step 3: Compare the best vaults across protocols\nphilidor compare <best-morpho-id> <best-aave-id> <best-yearn-id> --json\n# Cross-protocol comparison for the same asset class\n\n# Step 4: Get protocol-level details\nphilidor protocol morpho --json\n# Protocol detail: audit status, versions, incident history, chain coverage\n\n# Decision: Compare yield vs risk across protocols.\n# Note audited vs unaudited versions and flag incident history.\n\nWorkflow 3: Analyze Portfolio Risk\n\nStep-by-step pattern for assessing and improving a wallet's DeFi risk profile.\n\n# Step 1: Get all positions\nphilidor portfolio 0xWalletAddress --json\n# All positions: vault, chain, balance_usd, APR, risk_score, risk_tier\n# Aggregates: total value, weighted risk, position count, risk distribution\n\n# Step 2: Identify risky positions\n# Filter results for positions with risk_tier = \"Edge\" or risk_score < 5\n\n# Step 3: Investigate each risky position\nphilidor risk breakdown <risky-vault-id> --json\n# What is driving the low score? Asset? Platform? Control?\n\n# Step 4: Find safer alternatives for the same asset\nphilidor search \"USDC prime audited\" --json\n# Or use:\nphilidor vaults --asset USDC --risk-tier prime --audited --json\n# Find Prime-tier alternatives for the same asset\n\n# Decision: Present a portfolio risk summary to the user.\n# Highlight Edge-tier positions and suggest Prime alternatives\n# with comparable or better yield.\n\nWorkflow 4: Monitor Vault Safety\n\nStep-by-step pattern for ongoing safety monitoring.\n\n# Step 1: Check for active incidents across all protocols\nphilidor risk incidents --json\n# Vaults with recent critical incidents\n\n# Step 2: Check oracle health\nphilidor oracles freshness --json\n# Oracle feed freshness: stale feeds, deviation alerts\n\n# Step 3: Check event history for a specific vault\nphilidor vault <network> <address> --events --json\n# Event timeline: incidents, parameter changes, pauses\n\n# Decision: Flag vaults with active incidents or stale oracle feeds.\n# Recommend pausing deposits until issues are resolved.\n\nInterpreting Output\n\nKey fields and their formats:\n\nField\tFormat\tExample\tNotes\napr_net\tDecimal\t0.0523\tTotal APR = 5.23%. Includes base yield + rewards.\nbase_apr\tDecimal\t0.0340\tBase yield only = 3.40%. Native protocol rate before incentives.\ntvl_usd\tNumber (string)\t\"12500000.50\"\tTotal value locked in USD. Returned as string for precision.\ntotal_score\tNumber or null\t8.3\tComposite risk score 0-10. Null means unrated.\nrisk_tier\tString\t\"Prime\"\tDerived from total_score: Prime (>=8), Core (5-7.9), Edge (<5).\nrisk_vectors\tObject\t{\"asset\":{\"score\":8.5},...}\tBreakdown: asset (40%), platform (40%), control (20%).\nis_audited\tBoolean\ttrue\tWhether the protocol version has been audited.\nlast_synced_at\tISO 8601\t\"2026-02-26T12:00:00Z\"\tWhen the vault data was last refreshed from on-chain.\nrewards\tArray\t[{\"token_symbol\":\"MORPHO\",\"apr\":0.018}]\tIndividual reward token APRs. Sum + base_apr = apr_net.\nError Handling\nError\tCause\tFix\nConnection refused\tAPI server unreachable\tCheck network connectivity. Verify --api-url if using a custom endpoint. The default is https://api.philidor.io.\n404 Not Found\tInvalid vault ID, protocol ID, or address\tVerify the vault ID exists with philidor vaults. Check that the network slug is correct (e.g., ethereum, not eth).\n429 Too Many Requests\tRate limit exceeded\tWait and retry. The public API allows generous read limits but has per-IP throttling. Space out bulk queries.\nRequest timeout\tAPI response took too long\tRetry the request. For large result sets, use --limit to reduce page size.\nInvalid chain\tUnsupported chain slug\tRun philidor chains to see valid chain slugs.\nBest Practices\n\nAlways use --json in agent workflows. JSON output is structured, stable, and machine-parseable. Table output is for human consumption only and may change format between versions.\n\nCheck risk before recommending any vault. Never recommend a vault based on APR alone. Always run philidor risk breakdown <id> and check for Edge-tier scores or recent incidents via philidor risk incidents.\n\nNote data freshness timestamps. The last_synced_at field indicates when vault data was last refreshed from on-chain sources. Data older than a few hours may not reflect current APR or TVL. Flag stale data to users.\n\nCross-reference incidents and oracle health. Before recommending a vault, check philidor risk incidents for active security events and philidor oracles freshness for stale price feeds. These can materially affect vault safety.\n\nUse portfolio context for personalised advice. When a user has a wallet address, start with philidor portfolio <address> to understand their existing positions before suggesting new vaults. This enables risk-aware recommendations that consider concentration and diversification.\n\nResources\nWebsite: https://philidor.io\nAPI Documentation: https://api.philidor.io/v1/docs\nRisk Methodology: philidor risk explain or https://philidor.io/risk"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/zkoranges/philidor",
    "publisherUrl": "https://clawhub.ai/zkoranges/philidor",
    "owner": "zkoranges",
    "version": "0.1.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/philidor",
    "downloadUrl": "https://openagent3.xyz/downloads/philidor",
    "agentUrl": "https://openagent3.xyz/skills/philidor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/philidor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/philidor/agent.md"
  }
}