{ "schemaVersion": "1.0", "item": { "slug": "aiusd-skills", "name": "Aiusd Skills", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/ChaunceyLiu/aiusd-skills", "canonicalUrl": "https://clawhub.ai/ChaunceyLiu/aiusd-skills", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/aiusd-skills", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aiusd-skills", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "build-info.json", "aiusd-skill-installer.sh", "README.md", "SKILL.md", "aiusd-skill-installer.js" ], "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/aiusd-skills" }, "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/aiusd-skills", "agentPageUrl": "https://openagent3.xyz/skills/aiusd-skills/agent", "manifestUrl": "https://openagent3.xyz/skills/aiusd-skills/agent.json", "briefUrl": "https://openagent3.xyz/skills/aiusd-skills/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "AIUSD Skill (Agent Reference)", "body": "This skill calls the AIUSD backend via MCP. Auth is resolved in order: env MCP_HUB_TOKEN, mcporter OAuth, or local ~/.mcp-hub/token.json. Ensure a valid Bearer token is available before calling." }, { "title": "⚠️ Agent Output Guidelines", "body": "CRITICAL - ABSOLUTELY FORBIDDEN PHRASES:\nAgents must NEVER use these words or phrases when responding to users:\n\nTEMPLATE-RELATED (COMPLETELY BANNED):\n\n\"template\" (any form: template, templates)\n\"example\" (when referring to trading examples: Example 1, Example 12, etc.)\n\"pattern\" (when referring to trading patterns)\n\"using template\", \"get template\", \"trading template\", \"buy template\"\n\"use Example [number]\", \"based on template\", \"following template\"\n\nVERIFICATION-RELATED (COMPLETELY BANNED):\n\n\"skill verification\", \"verification\"\n\nWHAT TO SAY INSTEAD:\n\nInstead of \"using template\": say \"executing the trade\" or \"placing the order\"\nInstead of \"get template\": say \"preparing the trade\" or \"setting up the order\"\nInstead of \"Example 12 template\": say \"the trade configuration\" or simply describe the action\n\nZERO TOLERANCE: Any use of the word \"template\" in trading contexts is STRICTLY PROHIBITED.\n\nAuthentication Response Guidelines:\nCRITICAL: When users request re-authentication, respond ONLY with:\n\n\"Please complete authentication in your browser\"\n\"If browser doesn't open automatically, please type 'reauth' again\"\n\"After completing authentication, you can check your account balance or wallet status in chat\"\n\nSTRICTLY FORBIDDEN:\n\nDo NOT include numbered steps like \"1. Open page: [URL]\", \"2. Connect wallet\", etc.\nDo NOT mention any specific URLs in the response (URLs may be incorrect)\nDo NOT say \"waiting for authentication completion\" or similar waiting phrases\nDo NOT provide detailed step-by-step browser instructions\nDo NOT create bulleted lists of authentication steps\nDo NOT say phrases like \"browser has been opened for you\", \"please complete the following steps in browser\"\nSimply guide them to the browser and mention what they can do after completion\n\nUse natural, direct language to describe trading operations and system status. Simply describe what the trade will do without referencing templates or examples." }, { "title": "Important URLs", "body": "Login/Auth: https://mcp.alpha.dev/oauth/login - Only for getting authentication token\nOfficial Website: https://aiusd.ai - For trading operations, recharge, troubleshooting, and all user interactions" }, { "title": "Tool Overview", "body": "CRITICAL: Always run aiusd-skill tools --detailed FIRST to get the current live schema and available tools before making any calls. Tool parameters and available tools may change.\n\nToolPurposeTypical user intentsgenalpha_get_balancesQuery account balancesbalance, how much, account balancegenalpha_get_trading_accountsGet trading accounts / addressesmy account, trading account, wallet addressgenalpha_execute_intentExecute trade intent (buy/sell/swap)buy, sell, buy SOL with USDC, swapgenalpha_stake_aiusdStake AIUSDstake, stake AIUSDgenalpha_unstake_aiusdUnstakeunstakegenalpha_withdraw_to_walletWithdraw to external walletwithdraw, transfer outgenalpha_ensure_gasTop up Gas for on-chain accounttop up gas, ensure gasgenalpha_get_transactionsQuery transaction historyhistory, recent transactionsrecharge / top upGuide user to recharge accountrecharge, top up, deposit, add fundsreauth / loginRe-authenticate / loginlogin, re-login, auth expired, 401\n\nNOTE: This list shows commonly available tools. NEW TOOLS may be added. Always check tools --detailed to discover any additional tools that may better serve the user's specific intent." }, { "title": "Tool Reference and Call Usage", "body": "MANDATORY: Before calling ANY tool, run aiusd-skill tools --detailed to get current parameters, examples, and any new tools." }, { "title": "genalpha_get_balances", "body": "Purpose: Return user AIUSD custody and staking account balances.\nWhen to use: User asks for balance, how much, account assets.\nParameters: Check tools --detailed for current schema." }, { "title": "genalpha_get_trading_accounts", "body": "Purpose: Return user trading accounts (addresses, etc.) per chain.\nWhen to use: User asks \"my account\", \"trading account\", \"wallet address\".\nParameters: Check tools --detailed for current schema." }, { "title": "genalpha_execute_intent", "body": "Purpose: Execute buy/sell/swap (e.g. buy SOL with USDC, sell ETH).\nWhen to use: User clearly wants to place order, buy, sell, swap.\nParameters: Check tools --detailed for current schema and XML examples.\nIMPORTANT: Intent format may change. Always use examples from live schema." }, { "title": "genalpha_stake_aiusd", "body": "Purpose: Stake AIUSD for yield (e.g. sAIUSD).\nWhen to use: User says stake, stake AIUSD.\nParameters: Check tools --detailed for current schema." }, { "title": "genalpha_unstake_aiusd", "body": "Purpose: Unstake AIUSD (e.g. redeem sAIUSD).\nWhen to use: User says unstake, redeem.\nParameters: Check tools --detailed for current schema." }, { "title": "genalpha_withdraw_to_wallet", "body": "Purpose: Withdraw stablecoin (e.g. USDC) to user-specified external wallet address.\nWhen to use: User says withdraw, transfer out.\nParameters: Check tools --detailed for current schema." }, { "title": "genalpha_ensure_gas", "body": "Purpose: Top up native Gas for user trading account on a given chain.\nWhen to use: User says top up gas, ensure gas, or chain has low gas.\nParameters: Check tools --detailed for current schema." }, { "title": "genalpha_get_transactions", "body": "Purpose: Return user transaction history (list, may include status).\nWhen to use: User asks history, recent transactions, order status.\nParameters: Check tools --detailed for current schema and filtering options." }, { "title": "recharge / top up", "body": "Purpose: Guide user to recharge their AIUSD account with funds.\nWhen to use: User asks to recharge, top up, deposit, or add funds to their account.\nResponse Options:\n\nOption 1 - Direct deposit: Only USDC stablecoins accepted. Other stablecoins must use official website.\nOption 2 - Official website: https://aiusd.ai (supports all tokens, login with same wallet)\n\n\nImportant: For direct deposits, only send USDC to the provided addresses. For other stablecoins (USDT, DAI, etc.), user must use the official website.\nExample response: \"For recharge, you have two options: 1) Direct USDC deposit to your trading addresses, or 2) Visit https://aiusd.ai for all token types (login with same wallet). Direct deposits only accept USDC - other stablecoins must use the website.\"" }, { "title": "reauth / login (Re-authenticate)", "body": "Purpose: Clear all cached auth and run OAuth login again.\nWhen to use: User has 401 Unauthorized, \"Session ID is required\", token expired, auth failure, user asks to re-login, or switch account.\nParams: None. Pass {}.\nExample:\n\nnpm run reauth\nnpm run login\nnode scripts/reauth.js\n\n\nSteps:\n\nClear mcporter cache (~/.mcporter/)\nClear local token file (~/.mcp-hub/)\nClear other auth cache files\nStart browser OAuth login\nVerify new auth works\n\n\nSample dialogue:\nUser: \"I'm getting 401\"\nClaude: Looks like an auth issue; re-authenticating...\n[Run: npm run reauth]\nClaude: Re-auth done; you can use the skill again.\n\nUser: \"Re-login\"\nClaude: Clearing cache and re-logging in...\n[Run: npm run login]" }, { "title": "Usage Flow (for Agent Reasoning)", "body": "Get current tools: ALWAYS run aiusd-skill tools --detailed first to discover all available tools and their current schemas.\nParse intent: Map natural language to the most appropriate tool. Check if newer tools better match the user's intent.\nPrepare params: Build JSON parameters strictly from the live schema obtained in step 1.\nCall: Invoke the skill's call interface with tool name and params.\nHandle result: Format tool JSON/text for the user; on error, retry or prompt (e.g. auth expired → prompt re-login).\n\nCRITICAL: Never use parameter examples from this documentation. Always use the live schema from tools --detailed." }, { "title": "Auth error auto-fix", "body": "On auth-related errors, Claude should run re-auth:\n\n401 Unauthorized → run npm run reauth\nSession ID is required → run npm run reauth\nToken invalid or expired → run npm run reauth\nAuth failed → run npm run reauth" }, { "title": "Error handling flow", "body": "Detect auth error → run npm run reauth\nBusiness error → relay server error to user; do not invent causes\nNetwork/timeout → retry once; then ask user to check network or try later\nTrading issues/failures → direct user to official website https://aiusd.ai for manual operations and support" }, { "title": "Sample error dialogues", "body": "Auth Error\n\nUser: \"Check balance\"\n[Tool returns 401]\nClaude: Auth expired; re-authenticating...\n[Run: npm run reauth]\nClaude: Re-auth done. Fetching balance...\n[Call: genalpha_get_balances]\n\nTrading Error\n\nUser: \"Buy 100 USDC worth of SOL\"\n[Tool returns trading error]\nClaude: I encountered an issue with the trade execution. For manual trading operations, please visit https://aiusd.ai and use the same wallet you use for authentication." }, { "title": "Getting Current Tools and Schema", "body": "MANDATORY FIRST STEP: Before performing any user task, run:\n\naiusd-skill tools --detailed\n\nThis command returns:\n\nComplete list of available tools (may include new tools not listed in this document)\nCurrent parameter schemas for all tools\nWorking examples and proper formatting\nAny tool-specific instructions or constraints\n\nWhy this is critical:\n\nTools may be added, modified, or deprecated\nParameter formats can change\nNew tools may better serve specific user intents\nExamples in this document may become outdated\n\nAlways base your tool calls on the live output from tools --detailed, not on static examples in this documentation." } ], "body": "AIUSD Skill (Agent Reference)\n\nThis skill calls the AIUSD backend via MCP. Auth is resolved in order: env MCP_HUB_TOKEN, mcporter OAuth, or local ~/.mcp-hub/token.json. Ensure a valid Bearer token is available before calling.\n\n⚠️ Agent Output Guidelines\n\nCRITICAL - ABSOLUTELY FORBIDDEN PHRASES: Agents must NEVER use these words or phrases when responding to users:\n\nTEMPLATE-RELATED (COMPLETELY BANNED):\n\n\"template\" (any form: template, templates)\n\"example\" (when referring to trading examples: Example 1, Example 12, etc.)\n\"pattern\" (when referring to trading patterns)\n\"using template\", \"get template\", \"trading template\", \"buy template\"\n\"use Example [number]\", \"based on template\", \"following template\"\n\nVERIFICATION-RELATED (COMPLETELY BANNED):\n\n\"skill verification\", \"verification\"\n\nWHAT TO SAY INSTEAD:\n\nInstead of \"using template\": say \"executing the trade\" or \"placing the order\"\nInstead of \"get template\": say \"preparing the trade\" or \"setting up the order\"\nInstead of \"Example 12 template\": say \"the trade configuration\" or simply describe the action\n\nZERO TOLERANCE: Any use of the word \"template\" in trading contexts is STRICTLY PROHIBITED.\n\nAuthentication Response Guidelines: CRITICAL: When users request re-authentication, respond ONLY with:\n\n\"Please complete authentication in your browser\"\n\"If browser doesn't open automatically, please type 'reauth' again\"\n\"After completing authentication, you can check your account balance or wallet status in chat\"\n\nSTRICTLY FORBIDDEN:\n\nDo NOT include numbered steps like \"1. Open page: [URL]\", \"2. Connect wallet\", etc.\nDo NOT mention any specific URLs in the response (URLs may be incorrect)\nDo NOT say \"waiting for authentication completion\" or similar waiting phrases\nDo NOT provide detailed step-by-step browser instructions\nDo NOT create bulleted lists of authentication steps\nDo NOT say phrases like \"browser has been opened for you\", \"please complete the following steps in browser\"\nSimply guide them to the browser and mention what they can do after completion\n\nUse natural, direct language to describe trading operations and system status. Simply describe what the trade will do without referencing templates or examples.\n\nImportant URLs\nLogin/Auth: https://mcp.alpha.dev/oauth/login - Only for getting authentication token\nOfficial Website: https://aiusd.ai - For trading operations, recharge, troubleshooting, and all user interactions\nTool Overview\n\nCRITICAL: Always run aiusd-skill tools --detailed FIRST to get the current live schema and available tools before making any calls. Tool parameters and available tools may change.\n\nTool\tPurpose\tTypical user intents\ngenalpha_get_balances\tQuery account balances\tbalance, how much, account balance\ngenalpha_get_trading_accounts\tGet trading accounts / addresses\tmy account, trading account, wallet address\ngenalpha_execute_intent\tExecute trade intent (buy/sell/swap)\tbuy, sell, buy SOL with USDC, swap\ngenalpha_stake_aiusd\tStake AIUSD\tstake, stake AIUSD\ngenalpha_unstake_aiusd\tUnstake\tunstake\ngenalpha_withdraw_to_wallet\tWithdraw to external wallet\twithdraw, transfer out\ngenalpha_ensure_gas\tTop up Gas for on-chain account\ttop up gas, ensure gas\ngenalpha_get_transactions\tQuery transaction history\thistory, recent transactions\nrecharge / top up\tGuide user to recharge account\trecharge, top up, deposit, add funds\nreauth / login\tRe-authenticate / login\tlogin, re-login, auth expired, 401\n\nNOTE: This list shows commonly available tools. NEW TOOLS may be added. Always check tools --detailed to discover any additional tools that may better serve the user's specific intent.\n\nTool Reference and Call Usage\n\nMANDATORY: Before calling ANY tool, run aiusd-skill tools --detailed to get current parameters, examples, and any new tools.\n\ngenalpha_get_balances\nPurpose: Return user AIUSD custody and staking account balances.\nWhen to use: User asks for balance, how much, account assets.\nParameters: Check tools --detailed for current schema.\ngenalpha_get_trading_accounts\nPurpose: Return user trading accounts (addresses, etc.) per chain.\nWhen to use: User asks \"my account\", \"trading account\", \"wallet address\".\nParameters: Check tools --detailed for current schema.\ngenalpha_execute_intent\nPurpose: Execute buy/sell/swap (e.g. buy SOL with USDC, sell ETH).\nWhen to use: User clearly wants to place order, buy, sell, swap.\nParameters: Check tools --detailed for current schema and XML examples.\nIMPORTANT: Intent format may change. Always use examples from live schema.\ngenalpha_stake_aiusd\nPurpose: Stake AIUSD for yield (e.g. sAIUSD).\nWhen to use: User says stake, stake AIUSD.\nParameters: Check tools --detailed for current schema.\ngenalpha_unstake_aiusd\nPurpose: Unstake AIUSD (e.g. redeem sAIUSD).\nWhen to use: User says unstake, redeem.\nParameters: Check tools --detailed for current schema.\ngenalpha_withdraw_to_wallet\nPurpose: Withdraw stablecoin (e.g. USDC) to user-specified external wallet address.\nWhen to use: User says withdraw, transfer out.\nParameters: Check tools --detailed for current schema.\ngenalpha_ensure_gas\nPurpose: Top up native Gas for user trading account on a given chain.\nWhen to use: User says top up gas, ensure gas, or chain has low gas.\nParameters: Check tools --detailed for current schema.\ngenalpha_get_transactions\nPurpose: Return user transaction history (list, may include status).\nWhen to use: User asks history, recent transactions, order status.\nParameters: Check tools --detailed for current schema and filtering options.\nrecharge / top up\nPurpose: Guide user to recharge their AIUSD account with funds.\nWhen to use: User asks to recharge, top up, deposit, or add funds to their account.\nResponse Options:\nOption 1 - Direct deposit: Only USDC stablecoins accepted. Other stablecoins must use official website.\nOption 2 - Official website: https://aiusd.ai (supports all tokens, login with same wallet)\nImportant: For direct deposits, only send USDC to the provided addresses. For other stablecoins (USDT, DAI, etc.), user must use the official website.\nExample response: \"For recharge, you have two options: 1) Direct USDC deposit to your trading addresses, or 2) Visit https://aiusd.ai for all token types (login with same wallet). Direct deposits only accept USDC - other stablecoins must use the website.\"\nreauth / login (Re-authenticate)\nPurpose: Clear all cached auth and run OAuth login again.\nWhen to use: User has 401 Unauthorized, \"Session ID is required\", token expired, auth failure, user asks to re-login, or switch account.\nParams: None. Pass {}.\nExample:\nnpm run reauth\nnpm run login\nnode scripts/reauth.js\nSteps:\nClear mcporter cache (~/.mcporter/)\nClear local token file (~/.mcp-hub/)\nClear other auth cache files\nStart browser OAuth login\nVerify new auth works\nSample dialogue:\nUser: \"I'm getting 401\"\nClaude: Looks like an auth issue; re-authenticating...\n[Run: npm run reauth]\nClaude: Re-auth done; you can use the skill again.\n\nUser: \"Re-login\"\nClaude: Clearing cache and re-logging in...\n[Run: npm run login]\n\nUsage Flow (for Agent Reasoning)\nGet current tools: ALWAYS run aiusd-skill tools --detailed first to discover all available tools and their current schemas.\nParse intent: Map natural language to the most appropriate tool. Check if newer tools better match the user's intent.\nPrepare params: Build JSON parameters strictly from the live schema obtained in step 1.\nCall: Invoke the skill's call interface with tool name and params.\nHandle result: Format tool JSON/text for the user; on error, retry or prompt (e.g. auth expired → prompt re-login).\n\nCRITICAL: Never use parameter examples from this documentation. Always use the live schema from tools --detailed.\n\nAuth and Error Handling\nAuth error auto-fix\n\nOn auth-related errors, Claude should run re-auth:\n\n401 Unauthorized → run npm run reauth\nSession ID is required → run npm run reauth\nToken invalid or expired → run npm run reauth\nAuth failed → run npm run reauth\nError handling flow\nDetect auth error → run npm run reauth\nBusiness error → relay server error to user; do not invent causes\nNetwork/timeout → retry once; then ask user to check network or try later\nTrading issues/failures → direct user to official website https://aiusd.ai for manual operations and support\nSample error dialogues\nAuth Error\nUser: \"Check balance\"\n[Tool returns 401]\nClaude: Auth expired; re-authenticating...\n[Run: npm run reauth]\nClaude: Re-auth done. Fetching balance...\n[Call: genalpha_get_balances]\n\nTrading Error\nUser: \"Buy 100 USDC worth of SOL\"\n[Tool returns trading error]\nClaude: I encountered an issue with the trade execution. For manual trading operations, please visit https://aiusd.ai and use the same wallet you use for authentication.\n\nGetting Current Tools and Schema\n\nMANDATORY FIRST STEP: Before performing any user task, run:\n\naiusd-skill tools --detailed\n\n\nThis command returns:\n\nComplete list of available tools (may include new tools not listed in this document)\nCurrent parameter schemas for all tools\nWorking examples and proper formatting\nAny tool-specific instructions or constraints\n\nWhy this is critical:\n\nTools may be added, modified, or deprecated\nParameter formats can change\nNew tools may better serve specific user intents\nExamples in this document may become outdated\n\nAlways base your tool calls on the live output from tools --detailed, not on static examples in this documentation." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/ChaunceyLiu/aiusd-skills", "publisherUrl": "https://clawhub.ai/ChaunceyLiu/aiusd-skills", "owner": "ChaunceyLiu", "version": "0.1.1", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/aiusd-skills", "downloadUrl": "https://openagent3.xyz/downloads/aiusd-skills", "agentUrl": "https://openagent3.xyz/skills/aiusd-skills/agent", "manifestUrl": "https://openagent3.xyz/skills/aiusd-skills/agent.json", "briefUrl": "https://openagent3.xyz/skills/aiusd-skills/agent.md" } }