CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

workspace-surface-audit

Audit the active repo, MCP servers, plugins, connectors, env surfaces, and harness setup, then recommend the highest-value ECC-native skills, hooks, agents, and operator workflows. Use when the user wants help setting up Claude Code or understanding what capabilities are actually available in their environment.

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, lean instruction-only skill: a clear three-phase audit workflow, concrete file and key-name targets, a gap-to-shape decision table, and a fixed output format with success criteria. The main improvement opportunities are adding concrete discovery commands for the inventory phase, an explicit validation pass over inventory claims, and deduplicating the twice-stated gap taxonomy.

Suggestions

Add concrete inventory commands to Phase 1 (e.g. the CLI/plugin/connector listing commands to run) so the executor does not have to discover how to enumerate plugins, MCP servers, and connectors.

Add an explicit validation checkpoint between Phase 1 and Phase 2 — e.g. re-verify each claimed surface against the actual file or config it was inferred from — to close the workflow's minor feedback-loop gap.

State the available / primitive-only / missing taxonomy once (in Output Format) and reference it from Non-Negotiable Rules instead of repeating it in both places.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence (never explains what MCP servers or plugins are) and stays lean — file lists, a decision table, and output structure with no filler. Minor trimmable redundancy keeps it at the 4 anchor: the three-way available/primitive/missing taxonomy appears twice ("already available now / available but not wrapped well / not available" in Non-Negotiable Rules, then again as the Parity / Primitive-only gaps / Missing integrations output sections), and "Inspect only the files and settings needed to answer the question well" is throat-clearing.

4 / 5

Actionability

For an instruction-only skill the guidance is concrete: exact files to inspect (".mcp.json", ".claude/settings*.json", "package.json"), named env key examples ("STRIPE_API_KEY", "TWILIO_AUTH_TOKEN"), a gap-to-shape decision table, a fixed five-section output format, and illustrative callouts ("Stripe is available via connected app, but ECC lacks a billing-operator skill"). It falls short of fully executable because no concrete commands are given for the inventory phase (e.g. how to list installed plugins, enabled connectors, or MCP servers), leaving the executor to discover those.

4 / 5

Workflow Clarity

The three phases (Inventory → Benchmark → Decide) are clearly sequenced, Phase 2 supplies per-item checkpoint questions ("what they actually do / whether ECC already has parity / only primitives / missing entirely") and "Good Outcomes" defines success criteria. It sits at the 4 anchor rather than 5 because there is no explicit validation step confirming inventory claims against actual file contents before recommendations are made — a minor checkpoint gap, though the skill is read-only so no destructive-operation cap applies.

4 / 5

Progressive Disclosure

The skill is self-contained with no bundle files and no content that warrants splitting out — every section is short, well-labeled, and belongs in the main file, and navigation is easy via the clear heading hierarchy. Per the scoring notes, a skill with no need for external references can score 5 with well-organized sections, which this matches; nothing is inlined that should live in a separate reference.

5 / 5

Total

17

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit two-part structure: concrete audit-and-recommend actions enumerated across specific surfaces, followed by a clear Use-when trigger clause. Its only weaknesses are a trigger phrase ("help setting up Claude Code") that overlaps with generic config skills and the omission of natural trigger variations the body already contains.

Suggestions

Fold one or two of the body's natural trigger phrasings into the description, e.g. append "...or asks 'what am I missing?' / 'what plugins or MCPs should I use?'" to the Use-when clause.

Sharpen the trigger away from generic setup help, e.g. "Use when the user wants a capability/coverage audit of their Claude Code environment" to reduce overlap with general setup and config skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions across a comprehensive surface: "Audit the active repo, MCP servers, plugins, connectors, env surfaces, and harness setup, then recommend the highest-value ECC-native skills, hooks, agents, and operator workflows." Both the audit inputs and the output artifact types are enumerated specifically, matching the comprehensive anchor rather than the 4 anchor which has minor coverage gaps.

5 / 5

Completeness

Both halves are explicit: the "what" is stated concretely (audit listed surfaces, then recommend ECC-native skills/hooks/agents/workflows) and an explicit "Use when..." clause gives concrete trigger conditions. This matches the anchor requiring both what and when with concrete trigger phrases; not the 4 anchor where "when" could be more specific.

5 / 5

Trigger Term Quality

"Use when the user wants help setting up Claude Code or understanding what capabilities are actually available" contains natural phrases users would say, but common variations present in the body's When to Use list ("what plugins or MCPs should I use?", "recommend automations", "what am I missing?") are missing from the description itself. Good coverage with a few natural terms missing — the 4 anchor — not the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The ECC-native framing ("ECC-native skills, hooks, agents", "connectors, env surfaces") carves out a clear niche, but the trigger "help setting up Claude Code" is broad enough to overlap with general setup/config skills, putting it at the 4 anchor (mostly distinct, minor overlap with closely related skills) rather than 5 (minimal conflict risk).

4 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/workspace-surface-audit/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.