Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
affaan-m avatar

Workspace Surface Audit

  • 1.4k installs
  • 238k repo stars
  • Updated August 5, 2026
  • affaan-m/ecc

This is a copy of workspace-surface-audit by affaan-m - installs and ranking accrue to the original listing.

workspace-surface-audit is a read-only agent skill that audits active repos, MCP servers, plugins, connectors, and environment surfaces to recommend the highest-value ECC skills, hooks, and workflows for developers setti

About

workspace-surface-audit is an ECC read-only audit skill answering what a workspace and machine can currently do and what to add or enable next. It reviews active repositories, MCP servers, plugins, connectors, and environment surfaces including .env, .mcp.json, and plugin configuration without modifying files unless the user explicitly requests implementation. Developers reach for workspace-surface-audit when asking to set up Claude Code, recommend automation, choose plugins or MCP servers, or identify missing workflow layers. The skill compares official marketplace plugins against ECC-native coverage and determines whether a capability should be a skill, hook, agent, MCP server, or external connector. It is the ECC-native alternative to generic setup audit plugins.

  • Read-only audit of active repo, MCP servers, plugins, connectors, .env, and harness setup
  • Recommends highest-value ECC-native skills, hooks, agents, and operator workflows
  • Compares official marketplace plugins against ECC-native coverage
  • Surfaces only provider names, capability names, file paths, and config existence (never prints secrets)
  • Answers "what am I missing?" before installing more skills or connectors

Workspace Surface Audit by the numbers

  • 1,387 all-time installs (skills.sh)
  • +84 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/affaan-m/ecc --skill workspace-surface-audit

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1.4k
repo stars238k
Last updatedAugust 5, 2026
Repositoryaffaan-m/ecc

How do you audit Claude Code MCP and plugin setup?

Instantly understand exactly what their current workspace, MCP servers, plugins, and environment can actually do before adding more AI coding capabilities.

Who is it for?

Developers onboarding Claude Code who need a read-only inventory of MCP servers, plugins, hooks, and skills before installing more tooling.

Skip if: Developers who already know their full toolchain and want the agent to immediately implement changes without a discovery audit.

When should I use this skill?

User asks to set up Claude Code, recommend plugins or MCP servers, audit the environment, or identify missing automation layers.

What you get

Read-only capability inventory, ECC skill recommendations, hook and agent suggestions, and marketplace coverage gap report.

  • Capability inventory report
  • ECC skill and hook recommendations
  • Marketplace coverage gap analysis

Files

SKILL.mdMarkdownGitHub ↗

ワークスペースサーフェス監査

読み取り専用の監査スキル。「このワークスペースとマシンが現在実際に何をできるか、次に何を追加または有効化すべきか?」という質問に答えるために使用する。

これはセットアップ監査プラグインに対するECCネイティブの回答である。ユーザーが明示的にフォローアップの実装を要求しない限り、ファイルを変更しない。

使用する場面

  • ユーザーが「Claude Codeをセットアップする」「自動化を推奨する」「どのプラグインまたはMCPを使うべきか?」または「何が足りないか?」と言う
  • スキル、フック、コネクターをさらにインストールする前にマシンやリポジトリを監査する
  • 公式マーケットプラグインとECCネイティブのカバレッジを比較する
  • ワークフローレイヤーの欠落を見つけるために .env.mcp.json、プラグイン設定、または接続されたアプリのサーフェスをレビューする
  • 機能がスキル、フック、エージェント、MCP、または外部コネクターのどれであるべきかを決定する

交渉不可能なルール

  • シークレット値を決して印刷しない。プロバイダー名、機能名、ファイルパス、キーまたは設定が存在するかどうかのみを表示する。
  • ECCがそのサーフェスを合理的に所有できる場合は、一般的な「別のプラグインをインストール」という推奨よりECCネイティブワークフローを優先する。
  • 外部プラグインをベースラインとインスピレーションとして扱い、権威ある製品境界としてではない。
  • 3つのことを明確に区別する:
  • 現在利用可能なもの
  • 利用可能だがECCのカプセル化が不十分なもの
  • 利用不可能で新しい統合が必要なもの

監査の入力

質問に答えるために必要なファイルと設定のみを確認する:

1. リポジトリサーフェス

  • package.json、ロックファイル、言語マーカー、フレームワーク設定、README.md
  • .mcp.json.lsp.json.claude/settings*.json.codex/*
  • AGENTS.mdCLAUDE.md、インストールマニフェスト、フック設定

2. 環境サーフェス

  • アクティブなリポジトリと明らかに隣接するECCワークスペース内の .env* ファイル
  • キー名のみを表示する(STRIPE_API_KEYTWILIO_AUTH_TOKENFAL_KEY など)

3. 接続されたツールサーフェス

  • インストール済みプラグイン、有効化されたコネクター、MCPサーバー、LSP、アプリ統合

4. ECCサーフェス

  • 要件をカバーする既存のスキル、コマンド、フック、エージェント、インストールモジュール

監査プロセス

フェーズ1:既存のものを棚卸しする

簡潔なインベントリを生成する:

  • アクティブなツールチェーンのターゲット
  • インストール済みプラグインと接続されたアプリ
  • 設定済みのMCPサーバー
  • 設定済みのLSPサーバー
  • キー名で示唆される環境ベースのサービス
  • ワークスペースに関連する既存のECCスキル

サーフェスが生の形式でしか存在しない場合は指摘する。例:

  • 「Stripeは接続されたアプリで利用可能だが、ECCには課金操作スキルがない」
  • 「Google Driveは接続されているが、ECCにはGoogle Workspaceネイティブの操作ワークフローがない」

フェーズ2:公式およびインストール済みサーフェスとベンチマーク比較する

ワークスペースを以下と比較する:

  • セットアップ、レビュー、ドキュメント、デザイン、またはワークフロー品質と重複する公式Claudeプラグイン
  • ClaudeまたはCodexにローカルインストールされたプラグイン
  • ユーザーが現在接続しているアプリのサーフェス

名前だけを列挙しない。各比較に対して以下を答える:

1. それらが実際に何をするか 2. ECCが同等の機能をすでに持っているか 3. ECCが生の形式のみを持っているか 4. ECCがそのワークフローを完全に欠いているか

フェーズ3:ギャップをECCの決定に変換する

各実際のギャップについて、適切なECCネイティブの形式を推奨する:

ギャップの種類優先するECC形式
繰り返し可能な操作ワークフロースキル
自動実行または副作用フック
特殊な委任役割エージェント
外部ツールブリッジMCPサーバーまたはコネクター
インストール/オンボーディングガイダンスセットアップまたは監査スキル

ニーズが運用的であってインフラストラクチャ的でない場合は、デフォルトで既存のツールをオーケストレーションするユーザー向けスキルを使用する。

出力フォーマット

この順序で5つのセクションを返す:

1. 現在のサーフェス

  • 現在利用可能なもの

2. 同等の機能

  • ECCがベースラインに一致または超えている場所

3. 生の形式のみのギャップ

  • ツールは存在するが、ECCには簡潔な操作スキルがない

4. 欠けている統合

  • まだ利用できない機能

5. 上位3-5の次のステップ

  • 影響度順の具体的なECCネイティブな追加

推奨ルール

  • 各カテゴリにつき最大1-2つの最も価値の高いアイデアを推奨する。
  • 明確なユーザー意図とビジネス価値を持つスキルを優先する:
  • セットアップ監査
  • 課金/顧客運用
  • Issue/プロジェクト運用
  • Google Workspace運用
  • デプロイ/運用コントロール
  • コネクターが企業固有の場合、それが実際に利用可能またはユーザーのワークフローに明らかに有用な場合のみ推奨する。
  • ECCがすでに強力な生の形式を持っている場合は、まったく新しいサブシステムを発明するのではなくカプセル化スキルを提案する。

良い結果

  • ユーザーが接続されているもの、欠けているもの、ECCが次に持つべきものをすぐに確認できる。
  • 推奨事項は再発見なしにリポジトリで実装できるほど具体的。
  • 最終的な回答はAPIブランドではなくワークフローを中心に整理されている。

Related skills

How it compares

Pick workspace-surface-audit over generic setup guides when you need a repo-specific inventory of MCP, plugins, and ECC coverage gaps before installing more tools.

FAQ

Does workspace-surface-audit modify project files?

workspace-surface-audit is read-only by default and does not change files unless the user explicitly requests follow-up implementation after reviewing the audit recommendations.

What does workspace-surface-audit inspect?

workspace-surface-audit reviews active repositories, MCP servers, plugins, connectors, .env files, .mcp.json, and connected app surfaces to map current capabilities and recommend ECC-native skills, hooks, and workflows.

AI & Agent Buildingagentsautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.