CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

council

Run a subagent council that investigates one question from several angles and returns a recommendation. Trigger: council.

59

Quality

74%

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 ./ywai/skills/council/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 orchestration skill: the six-phase workflow is exemplary, with explicit report-validation feedback loops, launch-failure recovery, and a copy-paste decision-memo template. Its weaknesses are redundancy (read-only rules repeated across three sections) and version-pinned model names that will age the roster and inflate token cost.

Suggestions

State the read-only/no-commit constraint once (in the Brief section) and have the Practical notes refer to it instead of repeating it, trimming roughly 10 lines.

Move the model-roster details (specific versions, substitution ladder, harness-specific model IDs) into a references/models.md and replace them with a one-line default roster plus a pointer, so version churn happens outside the always-loaded SKILL.md.

Include one minimal example launch prompt or brief so step 3's 'launch with a minimal prompt' guidance is fully executable rather than compositional.

DimensionReasoningScore

Conciseness

The body is mostly non-obvious harness-specific guidance, but it could be tightened: the read-only constraint is stated three times ("explicitly tell them not to edit files", the brief's "constraints, especially read-only/no commits/no PRs", and "tell children not to modify files, commit, create branches, or open PRs" in Practical notes), and time-sensitive version numbers ("Opus 4.7", "GPT 5.5", "Kimi 2.6", "GLM 5.1", "claude-opus-4-7") will age the roster without an old-patterns section. Fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4's minor-trimmings bar.

3 / 5

Actionability

Concrete, executable guidance throughout: launch mechanics ("launch them in separate `run_agents` calls because model selection is run-wide"), a 7-point structured report format, and a copy-paste-ready final answer template in a markdown code block. Falls short of anchor 5 only because no example launch prompt or brief is shown verbatim — the executor still has to compose them. Rubric's code-vs-instruction note applies: no code expected for a coordination skill, and the guidance is actionable.

4 / 5

Workflow Clarity

Six clearly sequenced phases with explicit feedback loops: "If a report is missing key evidence or makes an unsupported claim, send a focused follow-up question to that same child" (validate-report-fix loop), "If a long brief causes launch validation issues, launch with a minimal prompt and send the full brief... afterward" (launch error recovery), and a synthesis checklist ("lead with the recommendation... mention confidence and material unknowns"). Matches anchor 5's clear sequence, explicit validation, and error-recovery loops; the skill involves no destructive or batch operations, so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so this scores the single-file organization: six well-labeled sections plus a template and practical notes, easy to navigate. Not a 5 because the under-50-line exception doesn't apply (130 lines) and some content — the ~15 lines of model-roster naming and substitution rules — reads like reference material that could live in a separate file. Anchor 4 ('good structure; most content appropriately placed; minor organization gaps') fits.

4 / 5

Total

16

/

20

Passed

Description

62%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 short, third-person, and names a distinct niche with a clear 'what', but it under-delivers on triggers: a single bare keyword ('council') with no natural phrases or use-when context. It reads like a name tag rather than an activation surface, which limits both completeness and trigger quality.

Suggestions

Expand the trigger clause into a use-when sentence listing natural phrases, e.g. "Use when the user says 'council', asks for a second opinion or multi-model review of a decision, or wants a decision red-teamed from several angles."

Add one or two more concrete capabilities to the 'what' — e.g. "assigns different models and perspectives to each member, collects structured evidence reports, and synthesizes a decision memo" — to lift specificity from 1-2 actions to several.

Mention the signature use case ("best for judgment-heavy calls: architecture tradeoffs, risky bug fixes, rollout decisions") so the skill triggers even when the word 'council' is never said.

DimensionReasoningScore

Specificity

"Run a subagent council that investigates one question from several angles and returns a recommendation" names the domain (subagent council) with two concrete actions (investigate from several angles, return a recommendation), matching the anchor for 1-2 concrete actions without comprehensive coverage. Not a 4 because it omits what the skill coordinates (model diversity, structured reports, synthesis into a decision memo) — those specifics live only in the body.

3 / 5

Completeness

The 'what' is clear ("Run a subagent council that investigates one question from several angles and returns a recommendation") and an explicit trigger clause is present ("Trigger: council"), so it is not capped at 3 — but the 'when' is a bare one-word tag with no use-when phrasing or context, which is weaker than anchor 5's concrete trigger phrases. Fits anchor 4: both present, 'when' could be more explicit.

4 / 5

Trigger Term Quality

The only explicit trigger term is "Trigger: council", plus the phrase "subagent council"; the single keyword 'council' is natural but common variations users would say ("second opinion", "panel", "multi-model review", "red-team this decision") are missing. Fits anchor 3 ('some relevant keywords but missing common variations') better than anchor 4, which expects several natural terms.

3 / 5

Distinctiveness Conflict Risk

"subagent council" plus the single-word trigger 'council' carves a clear niche that would not naturally fire for PDF, git, or document skills. Not a 5 because 'investigates one question... and returns a recommendation' overlaps with general multi-agent/orchestration/review skills, leaving minor conflict risk with closely related skills.

4 / 5

Total

14

/

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

YoizenSA/dev-ai-workflow

Path

ywai/skills/council/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.