Agent skill

electron-code-signing

Electron code signing and notarization workflow for macOS, Windows, and Linux distribution. Anchors: • electron-builder documentation / 適用: Code signing configuration / 目的: Proper certificate management and platform-specific signing • Apple Developer Program / 適用: macOS signing and notarization / 目的: App Store and Gatekeeper compliance • Windows Authenticode / 適用: Windows EV/OV certificate signing / 目的: SmartScreen bypass and user trust Trigger: Use when configuring code signing for Electron apps, setting up certificates for macOS/Windows/Linux, implementing notarization workflows, resolving signing errors, or distributing signed executables. Keywords: code signing, electron-builder, notarization, certificate, macOS signing, Windows Authenticode, entitlements, hardened runtime, EV certificate

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/electron-code-signing

SKILL.md

Electron Code Signing

概要

Electronアプリケーションの配布には、各プラットフォームでの適切なコード署名が必須です。このスキルは、macOS(公証含む)、Windows(Authenticode)、Linuxのコード署名ワークフローを提供します。

ワークフロー

Phase 1: Certificate Setup

目的: 証明書の取得、インストール、検証

アクション:

  1. プラットフォームに応じた証明書を取得
  2. キーチェーン/証明書ストアにインストール
  3. 環境変数を設定

Task: agents/certificate-setup.md を参照

Phase 2: Configuration

目的: electron-builderの署名設定を構成

アクション:

  1. electron-builder.ymlに署名設定を追加
  2. エンタイトルメント(macOS)を構成
  3. CI/CD環境変数を設定

Task: agents/signing-configuration.md を参照

リソース: references/macos-signing-guide.md, references/windows-signing-guide.md

Phase 3: Signing & Notarization

目的: 実際の署名と公証プロセスを実行

アクション:

  1. アプリケーションをビルド
  2. 署名を実行
  3. 公証を申請(macOS)

Task: agents/signing-execution.md を参照

Phase 4: Verification

目的: 署名とセキュリティ設定を検証

アクション:

  1. 署名の有効性を確認
  2. Gatekeeper/SmartScreenテストを実行
  3. 問題を報告・修正

Task: agents/signing-verification.md を参照

Task仕様ナビ

Task エージェント 入力 出力
Certificate Setup certificate-setup.md プラットフォーム、証明書種 証明書インストール確認
Configuration signing-configuration.md プロジェクト構成、証明書 electron-builder設定
Signing Execution signing-execution.md ビルド済みアプリ 署名済みバイナリ
Verification signing-verification.md 署名済みバイナリ 検証レポート

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

ベストプラクティス

すべきこと

推奨事項 理由
本番証明書は環境変数で管理 セキュリティ確保
CI/CDで暗号化シークレット使用 証明書の安全な管理
署名前にローカルでテスト 問題の早期発見
macOSではHardened Runtime有効化 公証に必須
公証完了後にstaple実行 オフライン検証サポート
各プラットフォームで署名検証 配布前の品質確認

避けるべきこと

禁止事項 問題点
証明書をリポジトリにコミット セキュリティリスク
開発証明書で本番配布 信頼性の問題
公証なしでmacOSアプリ配布 Gatekeeperにブロックされる
Windowsで署名なし配布 SmartScreen警告
エンタイトルメントの過剰権限 セキュリティリスク

リソース参照

scripts/(決定論的処理)

スクリプト 機能
log_usage.mjs フィードバック記録
validate-skill.mjs スキル構造の検証

references/(詳細知識)

リソース パス 読込条件
macOS署名 references/macos-signing-guide.md macOS署名時
Windows署名 references/windows-signing-guide.md Windows署名時
Linux署名 references/linux-signing-guide.md Linux署名時

assets/(テンプレート)

アセット 用途
entitlements.plist macOSエンタイトルメント
electron-builder-signing.yml 署名設定テンプレート

変更履歴

Version Date Changes
2.0.0 2026-01-01 18-skills.md仕様準拠版に再構築
1.0.0 2025-12-31 初版作成

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results