Terminal
Terminal/Skill
Checks a Meta app's rate limits, call volume and deprecated Graph API versions, and returns one prioritized report of what needs action.
By Meta
Works with
npx skills add facebook/agentic-tools --skill api-healthMonitor API usage, rate limits, and deprecations for a Meta app.
Start tracking. Before any other work, call devtools_skill_invocation with action start and skill_name api-health. Pass skill_name api-health on every devtools_* tool call in the following steps.
Identify the app. Ask the user for the app name or ID. If they give a name (or aren't sure of the ID), call devtools_app_list (action list) and resolve it to an app_id — match the name case-insensitively. If several apps match or it's ambiguous, show the candidates (name, ID, viewer role) and ask the user to pick. If they give a numeric ID, use it directly.
Collect API health data in parallel:
devtools_api_usage with action rate_limits — current rate limit status per metricdevtools_api_usage with action call_volume — total calls vs quotadevtools_api_usage with action deprecations — deprecated APIs and migration guidesAnalyze and report:
Rate Limits
overall_status the response already carries — healthy, warning, critical, throttled, or unmetered. Do not re-derive it from the percentage; the server classifies on an unrounded value, so a borderline case can read critical while usage_percentage displays 100.usage_percentage for the call_count_usage_rate metric (0–100, rounded for display)cooling_down_minutes: estimated minutes until unblock, 0 when not over quotaunmetered, say the app is not metered rather than reporting 0% — it means no usable headroom reading, not spare capacityCall Volume
API Deprecations
Action Items
Offer deeper investigation based on findings:
endpoint param) to find the hot path/search-docs) for migration guidesEnd tracking. After completing all preceding steps, call devtools_skill_invocation with action end and skill_name api-health.
If the user wants to investigate a specific API endpoint, call devtools_api_usage with action call_volume and pass the endpoint parameter (e.g., /me/feed) to filter results to that path.
The lookback_minutes parameter controls the time range (default: 1440 = 1 day):
lookback_minutes = 60lookback_minutes = 10080lookback_minutes = 43200overall_status, so report that field rather than recomputing from usage_percentage.usage_rate in call_volume is a share of quota capped at 1.0 — 1.0 means the app is at its quota, and no value above it is reachable.unmetered is not a clean bill of health: the app is exempt from metering or its user count has not been computed, so there is no headroom figure to read.