New to Claude Skills? Learn how to install them →

Eaffaan-m on GitHub

ECC Configuration

Free

Streamline your ECC setup and management process.

by affaan-m239.3k stars on affaan-m/ecc
2 views
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What ECC Configuration does

The ECC Configuration skill provides a structured and interactive wizard for installing, updating, and reconfiguring the ECC (Enhanced Command Center) within various harnesses such as Claude Code, Codex, and Kimi. It ensures that the appropriate plugins, scopes, and hooks are respected during the setup process, allowing users to manage their ECC environment efficiently. The skill prevents manual copying of plugins and cloning to temporary directories, simplifying the installation process.

This skill operates through a series of clearly defined commands and steps. Initially, it checks the inventory of the current harness to summarize the ECC installation scope and status. Users will be prompted to make specific selections regarding the scope (user, project, or local) and the hook mode (off, minimal, standard, or strict). The wizard ensures that only valid options are presented, streamlining the decision-making process.

After gathering user inputs, the skill provides a preview of the actions to be taken before applying any changes. This dry-run feature allows users to verify their selections and ensures that the setup will proceed without errors. Once confirmed, the actual setup is executed, and a welcome message is displayed only upon successful completion. This ensures that users have a clear understanding of the installation status and any necessary follow-up actions.

This skill is particularly useful for developers and designers who regularly work with ECC in their projects and need a reliable way to manage configurations across different environments. By automating the setup process, it reduces the risk of errors and enhances productivity.

When to use it

Use this skill when setting up or reconfiguring ECC in environments like Claude Code, Codex, or Kimi.

When not to use it

This skill is not suitable for environments that do not support ECC or when manual configuration is preferred.

What you can build with it

Setting up ECC in Claude Code

Use the skill to quickly install and configure ECC in your Claude Code environment without manual intervention.

Updating ECC in Codex

Easily update your existing ECC installation in Codex using the guided wizard to ensure all configurations are correct.

Reconfiguring ECC for Kimi projects

Utilize the skill to reconfigure ECC settings for specific Kimi projects, ensuring the correct hooks and scopes are applied.

How to install ECC Configuration

View source

1. Install with the skills CLI

npx skills add affaan-m/ecc/configure-ecc --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by affaan-m

Everything Claude Code の設定

現在のハーネス内で対話式ウィザードを実行します。最初にインベントリを調べ、対応する選択肢だけを 収集し、プレビュー後に 1 回だけ確認し、非対話で適用・検証します。ウェルカム表示は成功後だけです。 ECC を一時ディレクトリへ clone したり、プラグインを手作業でコピーしたりしないでください。

ユーザー自身が操作するターミナルの正規エントリは ecc setupnpx ecc-universal setup です。 ハーネス内では、代わりに以下の明示的な非対話コマンドを使います。

現在のハーネスで分岐

  • Claude Code では、以下の完全なスコープ/フックウィザードを使います。
  • Codex では Codex ネイティブのプラグインライフサイクルを使います。Claude のスコープを提示したり、 Claude の ECC フック 4 段階を Codex に対応付けたりしません。
  • Kimi ではプロジェクトサーフェスを ./.kimi-code に導入します。Kimi は ECC の Claude ライフサイクル フックプロファイルに対応しません。
  • ハーネスを特定できない場合は、検出根拠を示し、変更コマンドの前に対象を質問します。

このスキルは導入後の再設定経路です。プロバイダー組み込みの初回導入 UI を横取り、または代替できません。

Claude Code: 完全な対話式ウィザード

1. 変更せずにインベントリを確認

両方のコマンドを実行し、ECC の導入スコープ、有効状態、marketplace ソースを要約します。

claude plugin list --json
claude plugin marketplace list --json

ecc@ecc が 1 つのみ既存する場合は再設定として扱います。Claude が所有する "Open home page" コントロールをインストールの根拠にしません。setup が複数の ECC スコープ、 旧式/手動導入、不正な設定、marketplace 衝突を報告したら停止し、返された復旧方法を示します。 削除対象を推測しません。

2. 2 つの選択だけを収集

スコープについて 1 回だけ質問し、必ず 1 つの値を選びます。

  • user | project | local
  • user はこのユーザーの全プロジェクトで使えます。
  • project はリポジトリ設定で共有されます。
  • local は現在のプロジェクトのみに非公開です。

選択済みまたはインストール中の表示は、実際に選んだ 1 スコープだけにします。唯一の既存スコープと異なる 値を選んだら、スコープ移行であると説明し、以下のコマンドに --move-scope を含めます。

フックモードについて 1 回だけ質問し、必ず 1 つの値を選びます。

  • off | minimal | standard | strict
  • off はスキルとコマンドを残し、ECC フック自動化を無効にします。
  • minimal は最軽量のライフサイクルと安全自動化のみを有効にします。
  • standard は品質と安全のバランスを取ります。
  • strict は最も強いチェックとリマインダーを有効にします。

フック設定は個人の Claude プラグイン設定であり、導入スコープには追従しません。

3. プレビューし、1 回だけ確認

プラグイン内蔵 setup スクリプトを優先します。2 つの選択値を代入し、スコープ移行の場合だけ --move-scope を含めます。

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

$CLAUDE_PLUGIN_ROOT がない場合は公開 npm パッケージを使います。

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

確認サマリーは 1 回だけ表示します。予定アクション、1 スコープ、1 フックモード、marketplace アクション、 および移行元から移行先を含め、yes/no を 1 回だけ質問します。ハーネスの Shell は通常非 TTY のため、 そこで bare な対話式 ecc setup を実行しません。

4. 明示した選択を適用

確認後、同じ経路を --dry-run なしで再実行します。全選択を明示し、JSON で成功を判定します。

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

フォールバック:

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

5. 検証後にウェルカムを表示

終了コードが 0 であり、setup 結果の scopehooks が選択値と一致することを必須とします。 その後、独立して実行します。

claude plugin list --json

選択スコープに有効な ecc@ecc が正確に 1 件ある場合のみ続行します。$CLAUDE_PLUGIN_ROOT があるときは、 成功した setup の actioninstalledupdatedmigratedresumedalready-migrated)を内蔵レンダラーへ渡します。

呼び出し前に、プロバイダーが報告したバージョンが scripts/lib/terminal-welcome.jsECC_VERSION_PATTERN に一致することを 確認します。予期しない値は shell に補間せず拒否してください。

node -e 'const { renderTerminalWelcome } = require(process.env.CLAUDE_PLUGIN_ROOT + "/scripts/lib/terminal-welcome"); process.stdout.write(renderTerminalWelcome({ action: process.argv[1], version: process.argv[2], color: process.stdout.isTTY }));' "<action>" "<installed-version>"

ウェルカムは 1 回だけ表示します。失敗、dry-run、キャンセル、スコープ/フック不一致、検証不能の場合は 表示せず、エラーと復旧手順を報告します。検証後は /reload-plugins または Claude Code の再起動を案内します。

Codex: ネイティブプラグインライフサイクル

codex plugin marketplace list --jsoncodex plugin list --available --json で確認します。 Codex ネイティブのプラグインコマンドには Claude 式 user | project | local 選択はありません。 Claude のスコープ/フック 4 段階は質問しません。Codex ネイティブプラグインはプロバイダー固有フックに対応しますが、 Codex はその明示的な信頼を求めます。Codex にその信頼判断を表示させ、Claude の 4 プロファイルが Codex に対応すると表現しません。

ECC marketplace がない場合は追加し、既存ならスナップショットを更新します。

codex plugin marketplace add affaan-m/ECC
codex plugin marketplace upgrade ecc --json

1 回だけ確認し、インストールまたは導入済みキャッシュの再現可能な更新を行い、検証します。

codex plugin add ecc@ecc --json
codex plugin list --json

JSON が ECC を導入済みと報告し、installedPath を提供した場合のみ続行し、検証済みバンドルからウェルカムを表示します。

installedPath は Codex JSON が返した絶対パスそのものだけを使い、制御文字を 拒否します。バージョンは ECC_VERSION_PATTERN で検証します。node を次の argument array で直接呼び出してください。これは shell コマンドではなく、ツール API 呼び出しです。

["<installedPath>/scripts/welcome.js", "--action", "configured", "--version", "<installed-version>"]

現在のハーネスが実行ファイルと argument array を分けて渡せない場合は、ウェルカム表示を スキップします。Codex JSON の値から shell コマンドを組み立ててはいけません。

Claude の off | minimal | standard | strict が Codex に適用されたとは表現しません。

Kimi: プロジェクトサーフェス

確認前に機能サマリーを示します。導入先は ./.kimi-code、ECC ライフサイクルフックは hooks=unsupported です。Claude のスコープ/フックモードを質問しません。まずプレビューします。

npx --yes --package ecc-universal ecc install --profile core --target kimi --dry-run

このプロジェクト導入先について 1 回だけ確認し、--dry-run を除いた同一コマンドを適用します。 検証コマンド:

npx --yes --package ecc-universal ecc doctor --target kimi

doctor が成功し、導入された指示とスキルが ./.kimi-code 内に留まることを確認した後だけ実行します。

npx --yes --package ecc-universal ecc welcome --action configured

Kimi が ECC ライフサイクルフックを導入または設定したとは表現しません。

Frequently asked questions about ECC Configuration

Similar skills