Fix Codesign Error

DevOps & Security

fix-codesign-error

Fix Codesign Error is an Agent Skill for devops & security published in the robinebers/openusage repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Slash command that inspects a macOS signing or entitlement failure and explains the minimum fix path. Invoke explicitly with /fix-codesign-error — this skill never self-triggers.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/robinebers/openusage/blob/HEAD/.agents/skills/fix-codesign-error/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/fix-codesign-error, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Fix Codesign Error

Inspect a macOS signing or entitlement failure and explain the minimum fix path.

Arguments

app: path to .app bundle or binary (optional)
identity: signing identity hint (optional)
mode: inspect or repair-plan (optional, default: inspect)

Workflow

Inspect the app bundle, executable, signing info, and entitlements.
Determine whether the problem is identity, provisioning, hardened runtime, sandboxing, or trust policy.
Summarize the exact failure class in plain language.
Provide the minimal repair sequence or validation command.

Guardrails

Never invent entitlements; read them from the binary or source files.
Distinguish local development signing problems from distribution or notarization failures.
Prefer verifiable commands like codesign -d, spctl, and plutil over guesswork.