CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ce-setup

Check Compound Engineering health and repo-local config, or scaffold a Compound Pack with `pack:<id>`.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/ce-setup/SKILL.md
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.

The body is a well-engineered orchestration document: executable commands with guards and fallbacks, explicit branching and approval gates for repo-local writes, and a clean one-level reference structure verified against the actual bundle. Its only weaknesses are minor — a vague version-detection step, slightly wordy host-behavior paragraphs, and post-fix re-verification living in a reference rather than the main flow.

Suggestions

Make Step 1 concrete: name where the plugin version is read from (e.g. a specific manifest path or CLI flag) instead of "reading the plugin metadata or manifest when the platform exposes it".

Add an explicit end-of-Phase-2 verification step (re-run the health check and confirm the previously reported issues are gone) rather than relying on the reference files to mention it.

DimensionReasoningScore

Conciseness

The body is dense and operational with no re-teaching of concepts Claude already knows — every section carries host-gotchas or project-specific rules ("the Bash tool's CWD is the user's project, not the skill dir"). A few passages, such as the Interaction Method paragraph and the host-specific invocation-rendering rules in Phase 3, are wordier than strictly needed, matching anchor 4 (efficient, minor instances that could be trimmed) rather than anchor 5.

4 / 5

Actionability

Provides a copy-paste-ready bash snippet with an existence guard and fallback message, exact display-text templates for the banner and summary, and explicit branch rules ("If this session has a writable git checkout, run Phase 2 locally"). Minor gaps remain — Step 1's "reading the plugin metadata or manifest when the platform exposes it" is vague about where to look, and "--version VERSION" is a placeholder — so it sits at anchor 4 rather than the fully-executable anchor 5.

4 / 5

Workflow Clarity

Phases 1-3 are clearly sequenced with numbered steps, explicit Phase-2 branching across local/remote/no-checkout cases, approval gates on every user-owned file change, and error paths (script-missing fallback, docs_root invalid -> "stop with an error"). Post-fix verification via re-running the health check is explicit only in the pack-scaffold reference, not in the main repo-fix flow, which is the minor checkpoint gap separating it from anchor 5.

4 / 5

Progressive Disclosure

The body is a clean orchestration overview: all four reference files are real, one level deep, and signalled with their purpose ("It carries Steps 4-9: removing the obsolete ... `compound-engineering.local.md`, refreshing the example config, ..."), the bundled script is invoked by absolute path with a fallback, and the assets plus `packs-resolve.py` are reachable as leaf payloads from the references or the check script. Content is appropriately split, matching anchor 5 (clear overview, well-signaled one-level-deep references, easy navigation).

5 / 5

Total

17

/

20

Passed

Description

57%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.

The description states a clear, distinct niche with a concrete pack-scaffolding action, but it lacks any "use when" trigger guidance and relies on high-level action phrases without saying what the health check or repo-local config work actually covers. It is functional for a disable-model-invocation skill invoked by name, yet below the rubric's standard for a fully self-describing description.

Suggestions

Add an explicit trigger clause, e.g. "Use when setting up or re-checking a Compound Engineering environment, or when the user asks to add or scaffold a Compound Pack (`pack:<id>`)."

Briefly enumerate what the health check covers (e.g. plugin version, optional tools, config.yaml validity, docs_root) so the "check health" action is concrete rather than generic.

Include one or two natural user phrasings ("set up", "environment check") as synonyms alongside the existing jargon to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ("Compound Engineering") and 2-3 actions ("Check ... health", "repo-local config", "scaffold a Compound Pack with `pack:<id>`"), but the actions stay high-level with no detail on what the health check inspects or what the config work involves. It matches anchor 3 (domain and 1-2 concrete actions, not comprehensive) better than anchor 4, which expects several specific actions with only minor gaps.

3 / 5

Completeness

The "what" is clear (three functions, including the pack-scaffold path with its argument), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps this dimension at 3 per the judging guidelines. The `pack:<id>` token is only a partial, syntax-level trigger, not a statement of when to invoke the skill.

3 / 5

Trigger Term Quality

Contains some relevant keywords ("Compound Engineering", "health", "scaffold", "Compound Pack", "pack:<id>") but misses the natural phrases a user would say, such as "set up", "environment check", or "install". Anchor 3 (some relevant keywords, missing common variations) fits; anchor 4 requires good coverage with only a few terms missing.

3 / 5

Distinctiveness Conflict Risk

The description is scoped to the named "Compound Engineering" system with a distinct "Compound Pack" / "pack:<id>`" trigger vocabulary, giving it a clear niche with minimal conflict risk against unrelated skills. It clearly matches anchor 5; anchor 4 would require some overlap risk, which the named domain and bespoke invocation token avoid.

5 / 5

Total

14

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

EveryInc/compound-engineering-plugin

Path

skills/ce-setup/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.