Agent Skills › robinebers/openusage › fix-codesign-error

fix-codesign-error

GitHub

诊断 macOS 应用代码签名或权限失败，分析根本原因并提供最小修复路径。支持检查身份、配置集、沙盒等问题，推荐可验证命令，不臆造权限信息。

.agents/skills/fix-codesign-error/SKILL.md robinebers/openusage

Trigger Scenarios

macOS 应用签名报错 App 无法启动或验证失败需要解释代码签名错误

Install

npx skills add robinebers/openusage --skill fix-codesign-error -g -y

More Options

Non-standard path

npx skills add https://github.com/robinebers/openusage/tree/main/.agents/skills/fix-codesign-error -g -y

Use without installing

npx skills use robinebers/openusage@fix-codesign-error

指定 Agent (Claude Code)

npx skills add robinebers/openusage --skill fix-codesign-error -a claude-code -g -y

安装 repo 全部 skill

npx skills add robinebers/openusage --all -g -y

预览 repo 内 skill

npx skills add robinebers/openusage --list

SKILL.md

Frontmatter

{
    "name": "fix-codesign-error",
    "description": "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.",
    "disable-model-invocation": true
}

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.