Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    App Notarization Doctor

    1

    Diagnose macOS Gatekeeper blocks, signature errors, and notarization issues with safe remediation steps.

    Free

    1 useSecurity scanned
    App Notarization Doctor

    App Notarization Doctor

    Example session with this skill installed

    I just downloaded a tool called 'DataScraper.app' and macOS says it 'is damaged and can't be opened'. What's wrong?

    • Read your context and instructions
    • Compiled the app notarization doctor

    I have analyzed the security status of DataScraper.app. The "damaged" message on macOS usually indicates that the app has a quarantine flag and lacks a valid Developer ID signature or notarization ticket.

    App notarization diagnosis — DataScraper.app

    AttributeStatus
    Reported Message"App is damaged and can't be opened"
    Assessmentrejected (code object is not signed at all)
    Signature Typeadhoc
    NotarizationNo ticket found / Not notarized
    Quarantine Flagcom.apple.quarantine is present

    Diagnostic Findings

    The diagnostic tools spctl and codesign indicate this binary was compiled with an ad-hoc signature. Because it was downloaded from the internet, macOS has applied the com.apple.quarantine attribute. Gatekeeper blocks ad-hoc signed apps with this attribute by default to protect the system.

    Safe Options

    If you trust the source: You can manually remove the quarantine flag for this specific app. Run this command in Terminal:

    xattr -d com.apple.quarantine "/Applications/DataScraper.app"
    

    After running this, right-click the app and select Open.
    2.

    If you do not trust the source: Do not execute the command. Delete the application, as it lacks a verifiable developer identity.

    Next steps

    • Verify the download source matches the expected developer.
    • If you are the developer of this app, use macos-rust-app-releaser to sign and notarize it properly for distribution.
    • Run codesign -dv --verbose=4 "/Applications/DataScraper.app" to see the full signing metadata.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Users often encounter frustrating macOS security blocks like "App is damaged" or "unverified developer" when trying to run downloaded software. This skill provides a systematic diagnostic process to identify why Gatekeeper is blocking an app and offers safe, targeted fixes without compromising system security.

    What it does

    • Map error messages to specific root causes like quarantine flags, invalid signatures, or missing notarization tickets.
    • Perform read-only checks using standard macOS utilities to inspect code signatures and team identifiers.
    • Verify notarization status to check for stapled tickets or Apple's malicious software checks.
    • Identify signature types such as ad-hoc versus Developer ID to determine if a build was properly signed for distribution.
    • Provide safe remediation instructions for trusted apps while enforcing security best practices for untrusted ones.

    How it works

    1. Identify the block by analyzing the specific error message provided by the user or macOS.
    2. Execute diagnostics using commands like spctl and codesign to inspect the app bundle's metadata.
    3. Analyze findings to determine if the issue is a simple quarantine flag or a more serious signature invalidity.
    4. Issue recommendations with specific terminal commands for the user to run manually if they trust the source.

    Frameworks & tools

    This skill uses native macOS security tools including codesign, spctl, and xattr. It is designed specifically for the macOS environment and Gatekeeper security subsystem.

    Why this beats prompting it yourself

    Generic AI prompts often suggest dangerous global security overrides like disabling Gatekeeper system-wide. This skill follows a strict "least-privilege" diagnostic path, identifying the exact attribute causing the block so you can fix one specific app safely.

    Use cases

    • Fixing "damaged" apps that were downloaded from trusted sources but blocked by the quarantine flag.
    • Verifying third-party tools to check their Team ID and signature validity before execution.
    • Troubleshooting local builds to see why a compiled binary fails to run on another machine.

    Known limitations

    This is a diagnostic tool and does not sign, notarize, or package apps itself. It only supports macOS and cannot perform automated fixes; users must manually execute the suggested commands.

    macOS only. Read-only diagnosis; it does not sign or notarize binaries. Does not support other operating systems. Requires manual execution of commands by the user.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    1 use

    Times used to date

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 26 days ago

    • Free with an Agensi account

    Requires

    macOS

    Permissions

    Terminal / Shell

    File Scopes

    /Applications/**
    ~/**/*.app
    Listed26 days ago

    What's inside

    Frequently Asked Questions

    The App Notarization Doctor analyzes specific macOS error messages (like 'App is damaged' or 'Unverified Developer') and provides a step-by-step diagnostic to identify if the issue is a simple metadata flag or a critical signature failure.

    This skill is compatible with any AI agent that has access to a standard terminal interface or can process user-provided command output from tools like `codesign` and `spctl`.

    No, it never suggests disabling Gatekeeper globally; instead, it provides 'least-privilege' remediation steps, such as targeting specific extended attributes (`xattr`) for a single trusted application.

    The skill is designed for macOS and requires the user to have a Mac to run the diagnostic commands it generates, as it relies on native tools like Apple's Security framework.

    No, this is a diagnostic and troubleshooting tool; it identifies why an app is failing security checks but does not possess the keys or tools to sign or notarize binaries for you.

    Updates are included with your purchase and are rolled out automatically to ensure the skill remains current with the latest macOS security policy changes and Gatekeeper updates.

    New in Testing & Debugging