push-notification-audit

Detect push notification guideline 4.5.5 violations in iOS/macOS projects.

13|1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/cruisediary/apple-app-review-skills --skill push-notification-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: push-notification-audit
Source: https://github.com/cruisediary/apple-app-review-skills/tree/main/skills/quality/push-notification-audit
Command: npx skills add https://github.com/cruisediary/apple-app-review-skills --skill push-notification-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects push notification implementations that violate Guideline 4.5.5 by identifying premature permission prompts, promotional content, and improper handling.

Core Features & Use Cases

  • Detects when push permission is requested at launch without user context.
  • Flags promotional or marketing content in push payloads and ads in notifications.
  • Verifies presence of a notification delegate and proper handling of user responses.
  • Checks for proper push entitlements (aps-environment) and related configuration.
  • Provides actionable findings with file paths and line numbers for remediation.

Quick Start

Run the push notification audit on your iOS project root to surface premature permission requests, marketing use, and missing push entitlements.

Frequently Asked Questions about push-notification-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my iOS app for push notification App Store guideline 4.5.5 violations?

You can audit your iOS project by scanning AppDelegate.swift and SceneDelegate.swift for premature permission prompts, promotional payloads, and missing UNUserNotificationCenter delegate handling to ensure compliance with guideline 4.5.5.

What triggers an App Store guideline 4.5.5 rejection for push notifications?

An App Store guideline 4.5.5 rejection is triggered by requesting push permission at launch without user context, using notifications for marketing, and improper handling of user responses in UNUserNotificationCenter.

How do I check if my UNUserNotificationCenter implementation is compliant?

Check your UNUserNotificationCenter implementation by verifying the presence of a notification delegate, confirming proper handling of user responses, and ensuring push entitlements like aps-environment are correctly configured.

Does this push notification audit work on macOS projects using remote notifications?

Yes, this push notification audit applies to iOS and macOS projects using UNUserNotificationCenter or remote notifications, examining notification payload construction and permission request timing.

What is the best way to detect promotional content in push notification payloads?

The best way to detect promotional content in push notification payloads is to analyze the payload construction for marketing material and ads, generating a prioritized findings list with file paths and line numbers.

Why was my app rejected for requesting push permission at launch?

Your app was likely rejected because requesting push permission at launch without user context violates guideline 4.5.5; permission prompts must be shown only when the user understands why they are needed.