CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

task-board-setup

Creates a Codex file-based task board. Explicit user invocation only.

Quality

70%

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/task-board-setup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 an efficiently written, well-sequenced instruction set with concrete paths, explicit validation checkpoints, and strong safety gates around destructive operations. Its main weaknesses are navigation and self-containment: most bundle reference files are never linked from the body, and a few compressed sentences lean on terms (spec modes, ref-11 controls) defined only in those unlinked files.

Suggestions

Link every bundle file from the body at its point of use — e.g. P1 → references/01-analysis.md, P5 → references/12-verify-report.md, upgrade → references/10-upgrade.md — so all 13 references and scripts/scope-guard.sh are discoverable from SKILL.md.

Define or drop undefined shorthand like "both spec modes" and "the three ref-11 controls", or point directly to the reference that defines them.

Add a short failure-handling branch to P5 (what to do when verification or idempotence checks fail) to close the workflow's missing feedback loop.

DimensionReasoningScore

Conciseness

The body is dense with instructions and contains no padding, no explanations of concepts Claude already knows, and no fluff — e.g. the mode table delivers one line per mode. It falls short of 5 due to minor redundancy ("never create or mirror it under another assistant namespace" and "do not create a duplicate board under another assistant namespace" repeat the same rule) and a few over-compressed sentences such as "The three ref-11 controls and task Methodology/Anti-drift cron sections are ungated in both spec modes", where "both spec modes" is never defined in the body.

4 / 5

Actionability

Mostly concrete: exact artifact paths (`.codex/agents/task-tracker.toml`, `.codex/features/board.md`, `TASK_TEMPLATE.md`, etc.), a precise mode-resolution rule with an explicit alias blacklist, and template pointers for the generation phases. Not 5 because the P1 analysis step ("Analyze repository domains, documentation, release conventions") stays high-level and its how-to lives in `references/01-analysis.md`, which the body never links, and the verification step similarly never points to its detail file.

4 / 5

Workflow Clarity

The P0→P5.5 phases are clearly sequenced with explicit validation: step 7 verifies "paths, TOML, skill frontmatter, folder/status invariants, board counts, link integrity, and idempotence", destructive modes confirm first with task counts and an `uninstall` alternative, and "run the `status` inventory afterwards as the proof" adds a post-action checkpoint. Not 5 because there is no error-recovery feedback loop telling Claude what to do when verification fails.

4 / 5

Progressive Disclosure

The body is a lean overview that appropriately pushes detail into reference files and clearly signals three of them (references/02, 03, 11 — all real files), but 10 of the 13 bundle files (01, 04–10, 12, 13) and scripts/scope-guard.sh are never mentioned anywhere in the body, and reference files chain to each other (ref 03 cites "ref 11" and "ref 05"), leaving most of the bundle unreachable by explicit navigation from SKILL.md. This matches the 'references present but not clearly signaled' anchor better than score 4's 'minor organization gaps'.

3 / 5

Total

15

/

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 and names a concrete, distinct deliverable, but it undersells the skill: only one of many operating actions is named and there is no positive 'use when' trigger guidance, only an invocation-only constraint. It reads as guard-railed rather than discoverable.

Suggestions

Add a positive trigger clause, e.g. "Use when the user explicitly asks to set up, inspect, or tear down a Codex task board".

Enumerate the main capabilities (status, install, upgrade, enable/disable, uninstall, purge) so the description reflects the skill's actual scope.

Include natural synonyms users might say — "task tracking", "todo board", "backlog" — alongside "task board" to improve trigger matching.

DimensionReasoningScore

Specificity

"Creates a Codex file-based task board" names the domain and one concrete action, but the skill's seven operating modes (status, install, upgrade, enable, disable, uninstall, purge) are entirely absent, so coverage is not comprehensive. It is above a score-2 'names the domain, generic action' anchor because 'Creates... task board' is a concrete deliverable, but below score 4 which expects several specific actions listed.

3 / 5

Completeness

The 'what' is clear ("Creates a Codex file-based task board"), but the 'when' is only the negative invocation constraint "Explicit user invocation only" — it states a trigger discipline without naming any natural trigger situation or phrase a user would say. Per the guideline, absence of a 'Use when...' clause or equivalent positive trigger guidance caps this at 3; it is not 2 because both what and a when-statement are present.

3 / 5

Trigger Term Quality

"task board" and "Codex" are terms a user might naturally say, but common variations and synonyms ("task tracking", "todo list", "backlog", "kanban", "progress board") are missing. This matches the 'some relevant keywords but missing common variations' anchor rather than score 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

"Codex file-based task board" plus "Explicit user invocation only" carves a mostly distinct niche and suppresses accidental auto-triggering, leaving only minor overlap risk with generic task-management skills. Not 5 because "task board" on its own still overlaps the task-management space should the Codex qualifier be missed.

4 / 5

Total

13

/

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/task-board-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.