- Home
- Skills
- Testing & Debugging
- App Notarization Doctor
Works with the AI Agents you already use
App Notarization Doctor
Diagnose macOS Gatekeeper blocks, signature errors, and notarization issues with safe remediation steps.
Free
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
| Attribute | Status |
|---|---|
| Reported Message | "App is damaged and can't be opened" |
| Assessment | rejected (code object is not signed at all) |
| Signature Type | adhoc |
| Notarization | No ticket found / Not notarized |
| Quarantine Flag | com.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-releaserto 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
- Identify the block by analyzing the specific error message provided by the user or macOS.
- Execute diagnostics using commands like
spctlandcodesignto inspect the app bundle's metadata. - Analyze findings to determine if the issue is a simple quarantine flag or a more serious signature invalidity.
- 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.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Testing & Debugging.
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
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
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
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 to use
No account required to browse
Trust & safety
Security scan
Security scan passed 26 days ago
- Free with an Agensi account
Permissions
File Scopes