CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

manager

Engineering manager agent for orchestrating complex software development tasks by coordinating specialized sub-agents and managing parallel work streams. Use for large initiatives requiring coordination across multiple specialists.

Quality

66%

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 ./plugins/dev-skills/skills/manager/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

48%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 presents a clear, well-sequenced orchestration methodology with a useful sub-agent decision framework, but it is significantly redundant — the same phase workflow is repeated four times — and its templates are placeholder skeletons with no worked examples. No external reference files exist, so all template content is inlined in one long file.

Suggestions

Consolidate the four restatements of the orchestration workflow (Your Role, Core Capabilities templates, Execution Patterns, and the 'When orchestrating' list) into a single canonical sequence, cutting the body by roughly half.

Replace placeholder templates like '[Task Name]' and 'Track A: [Independent work stream 1]' with one filled, concrete example (e.g., a real feature broken into tracks with actual task names and hours) so the output format is unambiguous.

Move the large analysis/dependency/progress templates into a references/ file (e.g., references/templates.md) and link to them from a short overview, keeping SKILL.md focused on the decision framework and execution sequence.

DimensionReasoningScore

Conciseness

The ~380-line body restates the same orchestration workflow at least four times ("Your Role" list, "Core Capabilities" templates, "Execution Patterns", and the numbered "When orchestrating" list), and the "Communication Style" section dispenses generic advice Claude already knows ("Clear instructions", "Transparent about blockers", "Under-promise, over-deliver"). This is noticeably verbose with several padded sections (anchor 2), though not the anchor-1 case of explaining basic external concepts — the bulk is templates, just redundant ones.

2 / 5

Actionability

Concrete elements exist: the "When to Use Which Skill" decision framework gives explicit conditions per sub-agent, and "$ARGUMENTS" dispatch (--analyze/--plan/--status) is explicit. But the core templates are placeholder skeletons ("[Task Name]", "Track A: [Independent work stream 1]", "Estimated Effort: [Hours/days]") rather than filled examples — analogous to pseudocode instead of executable code (anchor 3) — and no concrete delegation invocation or worked example is given, keeping it below anchor 4.

3 / 5

Workflow Clarity

The execution plan template sequences five phases with an explicit wait gate ("Wait for Phase 1 completion before proceeding"), maps dependencies and critical path, flags bottlenecks, and ends with a success-criteria checklist. This matches anchor 4's 'clear sequence with most checkpoints present'; validation is mentioned ("Review outputs: Validate work before proceeding", dedicated go-review phase) but stays implicit rather than an explicit validate-fix-retry loop, so anchor 5 is not reached.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent) and the body contains no external references at all — the four large templates (task analysis, dependency graph, execution plan, progress report) are all inlined in a single ~380-line file. Header structure is clear, but content that could be split into separate reference files is inline with no navigation pointers, which fits anchor 3 ('some structure but could be better organized; content that should be separate is inline') rather than anchor 4's appropriately split layout.

3 / 5

Total

12

/

20

Passed

Description

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

A solid description that explicitly covers what the skill does and when to use it, with good natural trigger terms and a mostly distinct orchestration niche. Its main weakness is that the stated actions are abstract manager-verbs rather than concrete operations, and the when-clause lacks user-utterance-style trigger phrases.

DimensionReasoningScore

Specificity

The description names three actions — "orchestrating complex software development tasks", "coordinating specialized sub-agents", "managing parallel work streams" — but these are abstract manager-verbs, comparable to 'Processes PDF files and extracts content' in concreteness, not tangible operations like the anchor-4 'extracts text, fills forms, converts pages'. It is above anchor 2 (which names the domain with minimal actions) because it lists multiple domain actions, but below anchor 4 because none of them is a concrete, verifiable operation.

3 / 5

Completeness

Both what ("orchestrating complex software development tasks by coordinating specialized sub-agents and managing parallel work streams") and when ("Use for large initiatives requiring coordination across multiple specialists") are explicitly present. It falls short of anchor 5 because the when-clause lacks concrete user-utterance triggers (e.g., 'when the user asks to orchestrate', 'when the user mentions large projects'), matching anchor 4's 'when could be more explicit or specific'.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "orchestrating", "coordinating", "complex software development tasks", "large initiatives", "coordination across multiple specialists", "parallel work streams" — phrases a user with this need would plausibly say. A few common variations are missing ("project management", "delegate", "break down tasks"), which fits anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The orchestrator framing — "coordinating specialized sub-agents", "managing parallel work streams" — carves a mostly distinct niche distinct from implementation or single-task skills. Minor overlap risk remains with closely related planning/delegation skills ('complex software development tasks' is broad), so anchor 4 fits better than anchor 5, and it is clearly more distinct than anchor 3's generic 'somewhat specific' example.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

rikdc/ai-skills

Path

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