ReportKit Agent Skills

Public agent skills for setting up and running ReportKit automations.

This repo contains two skills:

• $reportkit-setup: use when a person asks an agent to set up an automation that should send ReportKit updates.
• $reportkit-execution: use inside the automation when the agent has evaluated state and needs to send or skip the ReportKit update.

The split matters: setup is conversational and designs the report contract; execution is narrow, secret-safe, and sends with the local reportkit_send MCP helper or the hosted CLI fallback reportkit send --file payload.json.

For local Codex, Claude, Cursor, and other MCP-compatible AI apps, ReportKit setup now prefers the macOS app:

1. Sign into the ReportKit iPhone and macOS apps with the same account.
2. In the macOS app, enable MCP and copy the config.
3. Let the runtime agent call reportkit_send with the ReportKit JSON payload.

Hosted/cloud agents that cannot use the local macOS MCP helper should use a revocable REPORTKIT_AGENT_TOKEN secret and the CLI fallback.

ReportKit sends can target multiple iPhone surfaces:

• live_activity: Dynamic Island / Lock Screen Live Activity updates.
• widget: Home Screen / Lock Screen WidgetKit refresh snapshots.
• notification: grouped APNs alert notifications with notification.threadId.
• Control Widget state updates through notification.control.

Live Activity sends can also choose how updates are routed:

• start_new: create a fresh Live Activity for every send.
• update_existing: update an existing activity only; do not start a replacement when none is active.
• upsert_single: keep one active Live Activity per activityId, updating it when possible and starting it when needed.
• coalesce: combine multiple checks into one Live Activity by using a stable activityId plus a per-check coalesceKey.

Use upsert_single when a user wants only one Live Activity for a report. Use start_new when each run should stand alone. Use coalesce when several checks should share one combined Live Activity without overwriting each other.

Live Activity Examples

Use this skill when you want an agent to send focused, action-oriented Live Activity updates instead of another chat notification.

Ops Calm	Release Readiness	Mixpanel Funnel

App Store Analytics	Supabase Errors	GCloud Incident

Codex Agent Progress	Builder Launch Console	Builder Compact Console

Install

Ask your agent to install this skill repo, for example:

Install https://github.com/AndreasInk/ReportKit-Skill.git so I can set up ReportKit automations.
Use $reportkit-setup when we are designing or installing an automation.
Use $reportkit-execution inside the automation when it is time to send or skip.

Then start with $reportkit-setup when asking Codex to configure a report, monitor, schedule, CI check, or agent workflow. For local AI apps, have the ReportKit macOS app installed and MCP enabled first.

Inside an automation prompt, include $reportkit-execution so the runtime agent uses the stricter send/skip rules.

Repo Contents

• reportkit-setup/SKILL.md
• reportkit-execution/SKILL.md
• assets/live-activity-previews/

More Info

Read the docs here: https://andreas.craft.me/qtX8oWJYSSxbJ2

Join the iOS TestFlight here: https://testflight.apple.com/join/KCr6Sxgn

Download the latest macOS release here: https://github.com/AndreasInk/ReportKit-Skill/releases/tag/beta