CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

manager-setup

Configures Manager and review prompt modes. Explicit user invocation only.

Quality

61%

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

Fix and improve this skill with Tessl

tessl review fix ./.codex/plugins/brewtools/skills/manager-setup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 model of token efficiency with a clear mode table, explicit alias-retirement rules, and real safety gates for destructive operations. Its weaknesses are execution gaps (no concrete hook-registration or state-writing mechanics) and undiscoverable bundle references: seven reference files exist but none are named or linked, so Claude cannot navigate to them from the skill.

Suggestions

Name and link the reference files explicitly, e.g. "`++m` in plan mode: use [references/planmode.md](references/planmode.md); default: [references/full.md](references/full.md)" so the existing bundle is discoverable.

Add concrete execution detail for `install`/`upgrade`: what the SessionStart/UserPromptSubmit hook entries look like and what is written to `.codex/brewtools/manager/state.json`.

Add a post-action verification step (e.g., after install, confirm exactly one entry per event and report the armed state) to close the workflow-clarity validation gap.

DimensionReasoningScore

Conciseness

The body is lean and telegraphic with zero padding: "Resolve exactly one canonical mode", "Idempotent: a second run leaves exactly one entry per event", "Silence, elapsed time and tool errors are not approval". It assumes Claude's competence and never explains concepts Claude already knows; every token earns its place.

5 / 5

Actionability

The mode table gives concrete per-mode effects and the resolution rules are specific, but the actual execution details are missing: no commands, file contents, or hook-registration mechanics for how to "Register the SessionStart and UserPromptSubmit handlers" or what to write to `.codex/brewtools/manager/state.json`. This is "Some concrete guidance but incomplete... missing key details" rather than anchor 4's mostly-executable guidance.

3 / 5

Workflow Clarity

The mode-resolution logic and safety gates are explicit ("Obtain confirmation before global writes", purge must "state exactly what will be deleted before running it"), but there is no ordered end-to-end sequence and no post-action verification step (e.g., checking registration after install). This matches "Steps listed but validation gaps; sequence present but checkpoints missing or implicit" rather than anchor 4, which expects most checkpoints explicit.

3 / 5

Progressive Disclosure

The bundle contains seven reference files (full.md, planmode.md, architect.md, review-double.md, review-regression.md, cron.md, cron-plan.md) but the body never names or links any of them — the closest it comes is the vague "using the plan-aware reference in plan mode". References are present but not clearly signaled, matching "Some structure but... references present but not clearly signaled"; it is above anchor 2 because the body itself is well-sectioned and nothing that belongs in a separate file is inlined.

3 / 5

Total

14

/

20

Passed

Description

37%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 and honest about its invocation-only nature, but it undersells the skill: no concrete actions, no natural trigger phrases, and no explicit "Use when..." guidance. It reads more like a configuration note than a discoverable skill description.

Suggestions

Add a "Use when..." clause with concrete triggers, e.g. "Use when the user asks to install, enable, disable, or check manager/review prompt modes, or says 'manager mode' or '++m'."

List the concrete actions from the body (install, upgrade, enable, disable, uninstall, purge, status) instead of the generic "Configures".

Include the natural vocabulary users actually type ("manager mode", "++m", "++r", "strict level") so the description matches real requests.

DimensionReasoningScore

Specificity

"Configures Manager and review prompt modes" names the domain but offers only one generic action, matching "Names the domain but actions are minimal or generic" (cf. "Processes PDF files"). The concrete verbs the skill actually performs (install, enable, disable, purge) never appear, so it does not reach the 1-2 concrete actions of anchor 3.

2 / 5

Completeness

The "what" is stated ("Configures Manager and review prompt modes") but the "when" is only weakly implied by "Explicit user invocation only", which is a negative constraint rather than an explicit "Use when..." trigger clause. Per the judging guidelines a missing 'Use when...' clause caps completeness at 3; it is above anchor 2 because a clear what is present.

3 / 5

Trigger Term Quality

Only "Manager" and "review" serve as keywords, and the natural phrases a user would actually say ("manager mode", "++m", "prompt mode", "install the manager") are absent. This fits "One or two generic keywords; missing the natural phrases users say" better than anchor 3, which expects broader relevant keyword coverage.

2 / 5

Distinctiveness Conflict Risk

"Manager" is a distinct niche term, but "review prompt modes" overlaps with common review-related skills a user might invoke, so it "could still overlap with similar skills". The "Explicit user invocation only" guard reduces risk, but not enough for anchor 4's "minor overlap risk" given how broad "review" is.

3 / 5

Total

10

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

kochetkov-ma/claude-brewcode

Path

.codex/plugins/brewtools/skills/manager-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.