CtrlK
BlogDocsLog inGet started
Tessl Logo

ce-setup

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

60

Quality

70%

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

The canonical home for this skill is ce-setup in EveryInc/compound-engineering-plugin

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 SKILL.md body is a lean, highly actionable orchestration document: executable commands with fallbacks, a clear phased workflow with explicit decision branches, and clean delegation to real, verified reference files. Its only weaknesses are minor boilerplate repetition and the absence of an explicit post-fix verification loop in the main path.

DimensionReasoningScore

Conciseness

The body is dense and purely operational with no explanations of concepts Claude already knows, and it assumes competence throughout. It is not a 5 because of repeated boilerplate ("from this skill's directory" appears multiple times, the approval condition "offered and applied only if the user approves" is stated twice, and the canonical docs-root block is duplicated content) that could be tightened.

4 / 5

Actionability

Guidance is fully executable: a copy-paste-ready bash block with an explicit SKILL_DIR anchor and a built-in fallback branch for a missing script, exact display strings for the banner and Phase 3 summary, and precise conditional instructions for the --version flag. It is not 4 because no key execution detail is left to inference; the main gap is deliberately delegated to a real, verified reference file.

5 / 5

Workflow Clarity

The three-phase sequence is clear with an explicit three-branch decision tree in Step 3 and error handling (script fallback to inline checks, invalid docs_root stops with an error, Phase 2 skipped without a writable checkout). It is not 5 because the main fix path never explicitly instructs re-running the health check to verify Phase 2 changes — only the pack-scaffold reference path includes a "Verify with the health check" feedback loop.

4 / 5

Progressive Disclosure

The body is an overview only; Steps 4-9, the pack scaffold procedure, and the inline health-check equivalent are split into clearly signaled, one-level-deep references ("read `references/repo-fixes.md` from this skill's directory"), and every referenced path in the body and bundle (references/, scripts/, assets/) exists. Asset files referenced from repo-fixes.md are verbatim payloads to insert, not nested documentation, so navigation stays one level deep.

5 / 5

Total

18

/

20

Passed

Description

53%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 is concise, specific to its niche, and states concrete capabilities, but it lacks any explicit "when to use" trigger clause and omits natural trigger synonyms (notably "setup"). It is serviceable for an explicitly-invoked skill yet would benefit from an explicit trigger sentence.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to set up, check, or configure Compound Engineering, or to scaffold a pack with `pack:<id>`."

Include natural synonyms users would say — "setup", "install check", "environment check" — alongside the current domain terms.

Name one or two concrete checks the health pass performs (e.g. optional tools, config validity) to raise specificity from high-level to concrete actions.

DimensionReasoningScore

Specificity

The description names the domain ("Compound Engineering") and 2-3 actions ("Check ... health and repo-local config, or scaffold a Compound Pack"), but the actions are high-level and coverage is not comprehensive. It matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive") rather than 4, which expects several specific actions at the granularity of "Extracts text from PDF files, fills forms, converts pages to images".

3 / 5

Completeness

The "what" is clear (check health/config, or scaffold a pack), but there is no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only weakly implied by the `pack:<id>` argument hint. Per the rubric's guideline, a missing 'Use when...' clause caps completeness at 3; it is not 2 because the "what" is concrete, and not 4 because the "when" is never explicitly stated.

3 / 5

Trigger Term Quality

Relevant keywords are present ("health", "repo-local config", "scaffold", "Compound Pack", "pack:<id>") but common variations a user would naturally say ("setup", "install", "environment check", "diagnose") are missing. This fits anchor 3 ("Some relevant keywords but missing common variations or synonyms"), not 4's "Good keyword coverage; a few natural terms missing" given the missing headword "setup" is the skill's own name.

3 / 5

Distinctiveness Conflict Risk

The Compound Engineering niche is clear with distinct triggers (health check, repo-local config, pack scaffolding), giving minimal conflict with unrelated skills. It scores 4 rather than 5 because sibling skills in the same family (ce-work, ce-noslop are referenced in the body) overlap the "Compound Engineering" phrasing and the description does not fully disambiguate which CE skill handles a given request.

4 / 5

Total

13

/

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
crdant/compound-engineering-plugin
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.