CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-orchestration-advisor

Design multi-agent AI workflows with clear boundaries, handoffs, and monitoring. Use when a complex PM task should run as parallel specialized agents instead of one linear process.

66

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with a clearly sequenced interactive workflow and concrete worked examples. Its weaknesses are conciseness (heavy conceptual framing and some repetition) and progressive disclosure (a monolithic file with no bundle files to offload the extensive examples and framework exposition).

Suggestions

Trim the conceptual framing (comparison tables, named-framework exposition, and repeated Key/Critical Insight callouts) to assume Claude's baseline knowledge and cut the body substantially toward the actionable workflow.

Move the three full worked examples and the framework reference tables into separate reference files under references/ and link to them one level deep, keeping SKILL.md as a concise overview.

Consolidate the redundant "When to Use This Skill" and "Anti-Patterns" sections into a single guidance block to remove repetition.

DimensionReasoningScore

Conciseness

The ~765-line body contains substantial conceptual framing (comparison tables, "Critical/Key Insight" callouts, exposition of Teresa Torres, Marty Cagan, and the Productside Blueprint) and repeats guidance between the "When to Use This Skill" and "Anti-Patterns" sections that could be tightened. It is not a 1 because the core workflow steps are concrete rather than padded with truly basic explanations (e.g., what a library is), and not a 3 because much general PM/AI framing assumes too little of Claude and could be trimmed.

2 / 3

Actionability

As an interactive advisory skill it supplies concrete questions, a worked agent decomposition with JSON output formats, three full end-to-end examples (agents, topologies, metrics, evals), named monitoring approaches, and four specific eval types. It is not a 2 because the guidance is specific and copy-paste ready rather than abstract, and absence of code is appropriate for an instruction-only skill per the scoring notes.

3 / 3

Workflow Clarity

Steps 0-8 are explicitly sequenced with stated questions, selectable options, and user-response gates that act as checkpoints, plus checklists (Strategic Intent Checklist, monitoring dimensions, eval process) and a final synthesis template. It is not a 2 because the sequence and checkpoints are explicit; the destructive/batch cap does not apply since this is a non-destructive advisory design process.

3 / 3

Progressive Disclosure

Sections are well organized with headers and sibling-skill references (e.g., ../context-engineering-advisor/SKILL.md) that are one level deep, but no bundle files exist and the content is monolithic — the framework exposition and three full worked examples are inline rather than split into reference files. It is not a 3 because content is not appropriately split across files and there is no progressive disclosure via the skill's own bundle, and not a 1 because section structure and one-level references are present.

2 / 3

Total

10

/

12

Passed

Description

85%

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 strong: third-person, specific, with explicit what-and-when guidance and a clearly distinct niche. Its main weakness is trigger-term quality, where the phrasing leans on specialized PM/orchestration jargon rather than the most natural terms a user would actually say.

DimensionReasoningScore

Specificity

"Design multi-agent AI workflows with clear boundaries, handoffs, and monitoring" lists several concrete actions (design, define boundaries, set up handoffs, monitoring) rather than vague verbs. It is not a 2 because it enumerates multiple specific capabilities, not just a domain plus a few actions.

3 / 3

Completeness

It states both what the skill does ("Design multi-agent AI workflows...") and an explicit when clause ("Use when a complex PM task should run as parallel specialized agents instead of one linear process"). It is not a 2 because the trigger guidance is explicit, not merely implied.

3 / 3

Trigger Term Quality

"Use when a complex PM task should run as parallel specialized agents instead of one linear process" includes relevant trigger phrasing, but the terms ("parallel specialized agents", "complex PM task") are fairly specialized jargon and miss more common variations a user might say. It is not a 3 because natural-language coverage is incomplete, and not a 1 because there are usable, relevant keywords.

2 / 3

Distinctiveness Conflict Risk

The niche (multi-agent orchestration of parallel specialized agents for PM tasks, contrasted with linear processes) is distinct with unique triggers unlikely to fire for unrelated skills. It is not a 2 because the framing clearly differentiates it from generic PM or single-agent skills.

3 / 3

Total

11

/

12

Passed

Validation

81%

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

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (783 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 5 suspicious

Warning

Total

13

/

16

Passed

Repository
deanpeters/Product-Manager-Skills
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.