# app-health-check

Audits a Meta app's settings, security, compliance, app review status, rate limits and deprecated APIs in one report.

Skill by Meta. Category: Shipping and ops.

## Install

Project (for this project only):

```sh
npx skills add facebook/agentic-tools --skill app-health-check
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add facebook/agentic-tools --skill app-health-check -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 17. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/facebook/agentic-tools/app-health-check)

## Source

[Open the source](https://github.com/facebook/agentic-tools/tree/HEAD/plugins/devtools/skills/app-health-check). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: app-health-check
description: "Run a comprehensive health check on a Meta app — audits settings, security, compliance, app review status, rate limits, and API deprecations in one pass. Use when you want a full picture of an app's current state."
allowed-tools: mcp__devtools__devtools_app, mcp__devtools__devtools_app_review, mcp__devtools__devtools_compliance, mcp__devtools__devtools_api_usage, mcp__devtools__devtools_app_list, mcp__devtools__devtools_skill_invocation
license: MIT
---

# App Health Check

Run a full audit of a Meta app and produce an actionable report.

## Workflow

1. **Start tracking.** Before any other work, call `devtools_skill_invocation` with action `start` and `skill_name` `app-health-check`. Pass `skill_name` `app-health-check` on every `devtools_*` tool call in the following steps.

2. **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.

3. **Collect data in parallel.** Run all calls concurrently to minimize latency:
   - `devtools_app` with action `basic_settings` — app name, category, platform, contact info
   - `devtools_app` with action `security` — app secret rotation, allowed domains, data deletion URL
   - `devtools_compliance` with action `status` — open required actions, violations, recommendations
   - `devtools_app_review` with action `status` — current review state, pending submissions
   - `devtools_api_usage` with action `rate_limits` — current rate limit health
   - `devtools_api_usage` with action `deprecations` — deprecated APIs needing migration

4. **Synthesize the report.** Organize findings into these sections:

   ### Report Format

   **App Overview**
   - App name, ID, category, status

   **Security**
   - Highlight any issues: missing data deletion URL, stale app secret, overly broad domain allowlist
   - Flag if App Secret has not been rotated recently

   **Compliance**
   - List any open required actions with deadlines
   - List any active violations
   - Summarize recommendations

   **App Review**
   - Current review status
   - Any pending or rejected submissions
   - Permissions/features that still need review

   **API Health**
   - Rate limit status: report the `overall_status` field as returned — `healthy`, `warning`, `critical`, `throttled`, or `unmetered`
   - Usage at or above the 70% warning band, flagging 90%+ as critical
   - Deprecated APIs with severity and migration recommendations

   **Action Items**
   - Prioritized list of things to fix, ordered by severity (violations > required actions > recommendations > improvements)

5. **Offer next steps.** Suggest relevant follow-up skills:
   - `/compliance-check` for deeper compliance remediation
   - `/app-review-prep` if there are pending review requirements
   - `/webhook-setup` if webhooks aren't configured yet
   - `/api-health` for deeper API usage analysis and endpoint-level investigation

6. **End tracking.** After completing all preceding steps, call `devtools_skill_invocation` with action `end` and `skill_name` `app-health-check`.

## Tips

- If any MCP call fails, report the failure in the relevant section rather than aborting the whole check.
- Always include the app ID in the report header for easy reference.
- For apps with no issues, keep the report short — don't pad with unnecessary detail.
````

- Previous: [webhook-setup](https://syn4pse.dev/terminal/meta-webhook-setup.md)
- Next: [api-health](https://syn4pse.dev/terminal/meta-api-health.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
