ecc-setup-plus

Built on affaan-m/ECC by @affaan-m (248,596 stars, MIT). All credit for the original idea to them. This fork improves and repackages it; upstream license preserved in UPSTREAM_LICENSE.

A Claude Code skill that helps you set up ECC with a safe preview, one approval step, and a final check.

Built for developers who use ECC with Claude Code, Codex, or Kimi.

🤔 Why

ECC setup can change plugins, scopes, and hooks.

Each coding tool supports a different setup path. Mixing their commands can break the install.

This skill checks the current state first. It asks only for choices your tool supports. It shows the full plan before it makes a change.

If a check fails, it stops and shows safe repair steps.

⚡ Install

Run one command:

mkdir -p ~/.claude/skills/configure-ecc && curl -fsSL https://raw.githubusercontent.com/ecc-setup-plus/ecc-setup-plus/main/skill/SKILL.md -o ~/.claude/skills/configure-ecc/SKILL.md

The skill is one file. It needs no extra package to install.

🛠️ Usage

Ask Claude Code:

Use configure-ecc to set up ECC for this project.

The skill will first check the plugin and marketplace state. It will then ask you to choose:

1. An install scope: user, project, or local
2. A hook mode: off, minimal, standard, or strict

Expected preview:

Planned actions:
- Set up ECC for Claude Code
- Scope: project
- Hook mode: standard
- Marketplace change: none

Apply this plan? Yes or no

Nothing changes until you approve the preview. After approval, the skill applies the same plan and checks that one active ecc@ecc entry exists in the chosen scope.

It does not pick a scope or hook mode for you. It does not mix Claude Code, Codex, and Kimi commands in one run.

🔄 What we changed vs upstream

• 英語に全面的に書き直され、短文・箇条書き・明確な見出しによって読みやすさが大幅に改善されました。
• ツール別の分岐が明確化され、1 回のセットアップで Claude Code・Codex・Kimi のコマンドを混在させない規則が追加されました。
• Claude Code の事前確認項目と停止条件が具体化され、状態を読めない場合やプレビュー失敗時にも安全に停止するよう強化されました。
• スコープとフックをユーザーに代わって選ばないこと、スコープ移行時はプレビューと適用の両方に --move-scope を付けることが明記されました。
• 改訂版の提示範囲は承認サマリーの途中で終わっており、元版にあった適用・検証・ウェルカム表示・Codex の詳細手順は比較できません。

📄 License

This repo uses the MIT License. The upstream ECC license is preserved in UPSTREAM_LICENSE.