Screen Time API Engineer

Use this skill to implement and harden Screen Time API apps with a docs-first evidence model.

Rules

• Use this evidence order for decisions:

1. Canonical Apple docs and WWDC 2. Local SDK interfaces/headers 3. Project-observed implementations (Project Alpha/Project Beta) 4. Field notes (forums/medium)

• If sources conflict, prefer canonical + SDK behavior.
• Mark uncertain conclusions as inference and include a caveat.

Quick Start Workflow

1. Identify user goal category.
2. Open matching references from references/guides.
3. Cross-check critical API claims in references/evidence.
4. If implementation quality or regressions matter, use references/rundowns.
5. Produce output with explicit source/confidence labeling.

Goal to Reference Map

• Entitlements, signing, distribution approval:

- references/guides/02-authorization-setup.md - references/guides/19-release-and-app-review-checklist.md

• Family activity picker and token handling:

- references/guides/03-familycontrols-selection-and-token-model.md - references/guides/04-displaying-activity-labels-and-real-app-icons.md

• Shield policy and store behavior:

- references/guides/05-managedsettings-enforcement-patterns.md - references/guides/06-web-blocking-and-webdomain-policy.md

• Custom shield UI/action:

- references/guides/07-managedsettingsui-custom-shield-systems.md - references/guides/08-shield-actions-and-response-strategies.md

• Scheduling and monitor callbacks:

- references/guides/09-deviceactivity-scheduling-thresholds-and-errors.md - references/guides/10-deviceactivity-monitor-extension-playbook.md

• Usage analytics reporting:

- references/guides/11-deviceactivity-report-analytics-architecture.md

• Web usage control/reporting via ScreenTime framework:

- references/guides/12-screentime-framework-web-usage-reporting.md

• Onboarding and permission UX:

- references/guides/13-onboarding-and-permission-ui-blueprints.md

• End-to-end implementation reference:

- references/guides/14-app-and-website-blocking-reference-implementation.md

• Project deep dives and comparative hardening:

- references/guides/15-project-alpha-implementation-analysis.md - references/guides/16-project-beta-implementation-analysis.md - references/rundowns/12-cross-project-rundown.md

• Bug prevention, testing, and preflight:

- references/guides/17-hardening-checklist-bug-prevention.md - references/guides/18-testing-matrix-device-only-edge-cases.md - references/guides/21-preflight-rundown.md

Evidence Files (Use When Verifying API Contracts)

• references/evidence/01-familycontrols-sdk-signatures.md
• references/evidence/02-managedsettings-sdk-signatures.md
• references/evidence/03-managedsettingsui-sdk-signatures.md
• references/evidence/04-deviceactivity-sdk-signatures.md
• references/evidence/05-deviceactivity-report-sdk-signatures.md
• references/evidence/06-screentime-framework-headers.md
• references/evidence/07-claim-reconciliation.md
• references/evidence/00-source-url-inventory.md

Output Contract

When using this skill for implementation guidance, include:

1. Chosen API path and why.
2. Risks/failure modes.
3. Validation checklist.
4. Source citations with confidence labels.

Boundaries

• Do not infer private APIs or unsupported token conversion techniques.
• Do not claim behavior beyond canonical/SDK support without explicit caveats.
• Do not skip extension-signing parity checks when discussing release readiness.