{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kimi-usage-monitor",
    "name": "Kimi Usage Monitor",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/xD4O/kimi-usage-monitor",
    "canonicalUrl": "https://clawhub.ai/xD4O/kimi-usage-monitor",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/kimi-usage-monitor",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kimi-usage-monitor",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "check_usage.sh",
      "PLATFORM_SUPPORT.md",
      "README.md",
      "SKILL.md",
      "scripts/fetch_usage.py",
      "scripts/preflight_check.py"
    ],
    "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-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/kimi-usage-monitor"
    },
    "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/kimi-usage-monitor",
    "agentPageUrl": "https://openagent3.xyz/skills/kimi-usage-monitor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kimi-usage-monitor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kimi-usage-monitor/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": "Kimi Usage Monitor",
        "body": "Monitor Kimi K2.5 usage quotas from the Kimi console to make informed decisions about task prioritization and resource allocation."
      },
      {
        "title": "When to Use This Skill",
        "body": "Before intensive operations: Check quota before starting multi-step research or coding tasks\nAutonomous planning: Self-prioritize tasks based on remaining usage percentage\nRate limit awareness: Know when quotas reset to time high-priority work\nUsage tracking: Log patterns for long-term capacity planning"
      },
      {
        "title": "Quick Start",
        "body": "Prerequisites: Chrome with OpenClaw extension attached\n\nOpen Chrome → https://www.kimi.com/code/console?from=membership\nClick OpenClaw extension icon (badge should show ON)\nEnsure you're logged into Kimi\n\n# Check current usage (Linux/macOS/WSL)\n./check_usage.sh\n\n# Windows native\ncheck_usage.bat           # CMD\n.\\check_usage.ps1         # PowerShell\n\n# JSON output for automation (all platforms)\npython3 scripts/fetch_usage.py --json\n\nPlatform Support: Linux ✅ | macOS ✅ | Windows (WSL) ✅ | Windows (Native) ✅"
      },
      {
        "title": "Usage Data Available",
        "body": "The Kimi console shows:\n\nMetricDescriptionDecision ThresholdWeekly UsagePercentage of weekly quota consumed>75% = prioritizeWeekly ResetHours until quota resetsPlan heavy tasks after resetRate LimitAdditional rate limiting quotaSecondary resourceRate ResetHours until rate limit resetsShort-term buffer"
      },
      {
        "title": "Autonomous Decision Guidelines",
        "body": "When operating autonomously, use these heuristics:\n\n🟢 High Capacity (>50% remaining)\n\nProceed with full capability\nAccept multi-step research tasks\nSpawn subagents as needed\nEnable verbose reasoning\n\n🟡 Moderate Capacity (25-50% remaining)\n\nBatch similar operations\nPrefer concise outputs\nUse subagents sparingly\nDisable non-essential reasoning\n\n🔴 Low Capacity (<25% remaining)\n\nEssential tasks only\nSingle-step operations\nAvoid subagent spawning\nPrioritize user-directed work over proactive tasks"
      },
      {
        "title": "Pre-Flight Checks for Intensive Operations",
        "body": "Before spawning subagents or starting multi-step tasks, check capacity:\n\n# Check if operation should proceed\npython3 scripts/preflight_check.py [light|standard|intensive]\n\n# Light: single query, simple task (needs 10%)\n# Standard: normal subagent, research (needs 25%)\n# Intensive: multi-subagent, deep research (needs 50%)\n\nReturns exit code 0 if cleared, 1 if blocked. Use in scripts:\n\nif python3 scripts/preflight_check.py intensive; then\n    # Proceed with intensive operation\n    sessions_spawn \"Complex research task...\"\nfi"
      },
      {
        "title": "Subagent Guard",
        "body": "Check specifically before spawning subagents:\n\npython3 scripts/subagent_guard.py\n\nReturns JSON with can_spawn boolean:\n\n{\n  \"can_spawn\": true,\n  \"usage_percent\": 45,\n  \"remaining_percent\": 55,\n  \"resets_hours\": 36\n}"
      },
      {
        "title": "Integration Ideas",
        "body": "Hourly monitoring cron:\n\n# Add to crontab or OpenClaw jobs\n0 * * * * cd /path/to/kimi-usage-monitor && python3 scripts/usage_logger.py\n\nPre-task validation:\n\nimport subprocess\nresult = subprocess.run(\n    [\"python3\", \"scripts/preflight_check.py\", \"intensive\"],\n    capture_output=True\n)\nif result.returncode == 0:\n    # Proceed with task\n    pass"
      },
      {
        "title": "Script Reference",
        "body": "ScriptPurposescripts/fetch_usage.pyMain usage scraper (browser-based)scripts/usage_logger.pyAutonomous logging + decision wrapperscripts/preflight_check.pyPre-flight validation for operationsscripts/subagent_guard.pyCheck before spawning subagentscheck_usage.shQuick CLI wrapper\n\nNote: Alternative Playwright-based scraper (fetch_kimi_usage.py) available for non-OpenClaw environments (requires system dependencies)."
      },
      {
        "title": "Troubleshooting",
        "body": "\"Browser not available\"\n\nEnsure Chrome extension is attached (badge shows ON)\nVerify the Kimi console tab is open\n\n\"Could not detect usage\"\n\nMake sure you're logged into Kimi\nCheck that the console page has fully loaded\n\nAuthentication errors\n\nRe-authenticate at https://www.kimi.com/code/console\nThe browser tool uses your existing Chrome session"
      },
      {
        "title": "Human-Readable (default)",
        "body": "📊 Kimi Usage Monitor\n========================================\n\n🗓️  Weekly Usage\n   Used: 45%\n   Remaining: 55%\n   Resets in: 36 hours\n   Status: 🟡 Moderate — plan accordingly\n\n⚡ Rate Limit\n   Used: 2%\n   Resets in: 3 hours"
      },
      {
        "title": "JSON (--json flag)",
        "body": "{\n  \"weekly_usage_percent\": 45,\n  \"weekly_resets_hours\": 36,\n  \"rate_limit_percent\": 2,\n  \"rate_limit_resets_hours\": 3,\n  \"timestamp\": \"2026-02-12 21:15:00\"\n}"
      },
      {
        "title": "License",
        "body": "MIT License - Feel free to modify and distribute."
      }
    ],
    "body": "Kimi Usage Monitor\n\nMonitor Kimi K2.5 usage quotas from the Kimi console to make informed decisions about task prioritization and resource allocation.\n\nWhen to Use This Skill\nBefore intensive operations: Check quota before starting multi-step research or coding tasks\nAutonomous planning: Self-prioritize tasks based on remaining usage percentage\nRate limit awareness: Know when quotas reset to time high-priority work\nUsage tracking: Log patterns for long-term capacity planning\nQuick Start\n\nPrerequisites: Chrome with OpenClaw extension attached\n\nOpen Chrome → https://www.kimi.com/code/console?from=membership\nClick OpenClaw extension icon (badge should show ON)\nEnsure you're logged into Kimi\n# Check current usage (Linux/macOS/WSL)\n./check_usage.sh\n\n# Windows native\ncheck_usage.bat           # CMD\n.\\check_usage.ps1         # PowerShell\n\n# JSON output for automation (all platforms)\npython3 scripts/fetch_usage.py --json\n\n\nPlatform Support: Linux ✅ | macOS ✅ | Windows (WSL) ✅ | Windows (Native) ✅\n\nUsage Data Available\n\nThe Kimi console shows:\n\nMetric\tDescription\tDecision Threshold\nWeekly Usage\tPercentage of weekly quota consumed\t>75% = prioritize\nWeekly Reset\tHours until quota resets\tPlan heavy tasks after reset\nRate Limit\tAdditional rate limiting quota\tSecondary resource\nRate Reset\tHours until rate limit resets\tShort-term buffer\nAutonomous Decision Guidelines\n\nWhen operating autonomously, use these heuristics:\n\n🟢 High Capacity (>50% remaining)\n\nProceed with full capability\nAccept multi-step research tasks\nSpawn subagents as needed\nEnable verbose reasoning\n\n🟡 Moderate Capacity (25-50% remaining)\n\nBatch similar operations\nPrefer concise outputs\nUse subagents sparingly\nDisable non-essential reasoning\n\n🔴 Low Capacity (<25% remaining)\n\nEssential tasks only\nSingle-step operations\nAvoid subagent spawning\nPrioritize user-directed work over proactive tasks\nPre-Flight Checks for Intensive Operations\n\nBefore spawning subagents or starting multi-step tasks, check capacity:\n\n# Check if operation should proceed\npython3 scripts/preflight_check.py [light|standard|intensive]\n\n# Light: single query, simple task (needs 10%)\n# Standard: normal subagent, research (needs 25%)\n# Intensive: multi-subagent, deep research (needs 50%)\n\n\nReturns exit code 0 if cleared, 1 if blocked. Use in scripts:\n\nif python3 scripts/preflight_check.py intensive; then\n    # Proceed with intensive operation\n    sessions_spawn \"Complex research task...\"\nfi\n\nSubagent Guard\n\nCheck specifically before spawning subagents:\n\npython3 scripts/subagent_guard.py\n\n\nReturns JSON with can_spawn boolean:\n\n{\n  \"can_spawn\": true,\n  \"usage_percent\": 45,\n  \"remaining_percent\": 55,\n  \"resets_hours\": 36\n}\n\nIntegration Ideas\n\nHourly monitoring cron:\n\n# Add to crontab or OpenClaw jobs\n0 * * * * cd /path/to/kimi-usage-monitor && python3 scripts/usage_logger.py\n\n\nPre-task validation:\n\nimport subprocess\nresult = subprocess.run(\n    [\"python3\", \"scripts/preflight_check.py\", \"intensive\"],\n    capture_output=True\n)\nif result.returncode == 0:\n    # Proceed with task\n    pass\n\nScript Reference\nScript\tPurpose\nscripts/fetch_usage.py\tMain usage scraper (browser-based)\nscripts/usage_logger.py\tAutonomous logging + decision wrapper\nscripts/preflight_check.py\tPre-flight validation for operations\nscripts/subagent_guard.py\tCheck before spawning subagents\ncheck_usage.sh\tQuick CLI wrapper\n\nNote: Alternative Playwright-based scraper (fetch_kimi_usage.py) available for non-OpenClaw environments (requires system dependencies).\n\nTroubleshooting\n\n\"Browser not available\"\n\nEnsure Chrome extension is attached (badge shows ON)\nVerify the Kimi console tab is open\n\n\"Could not detect usage\"\n\nMake sure you're logged into Kimi\nCheck that the console page has fully loaded\n\nAuthentication errors\n\nRe-authenticate at https://www.kimi.com/code/console\nThe browser tool uses your existing Chrome session\nOutput Format\nHuman-Readable (default)\n📊 Kimi Usage Monitor\n========================================\n\n🗓️  Weekly Usage\n   Used: 45%\n   Remaining: 55%\n   Resets in: 36 hours\n   Status: 🟡 Moderate — plan accordingly\n\n⚡ Rate Limit\n   Used: 2%\n   Resets in: 3 hours\n\nJSON (--json flag)\n{\n  \"weekly_usage_percent\": 45,\n  \"weekly_resets_hours\": 36,\n  \"rate_limit_percent\": 2,\n  \"rate_limit_resets_hours\": 3,\n  \"timestamp\": \"2026-02-12 21:15:00\"\n}\n\nLicense\n\nMIT License - Feel free to modify and distribute."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/xD4O/kimi-usage-monitor",
    "publisherUrl": "https://clawhub.ai/xD4O/kimi-usage-monitor",
    "owner": "xD4O",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/kimi-usage-monitor",
    "downloadUrl": "https://openagent3.xyz/downloads/kimi-usage-monitor",
    "agentUrl": "https://openagent3.xyz/skills/kimi-usage-monitor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kimi-usage-monitor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kimi-usage-monitor/agent.md"
  }
}