CtrlK
BlogDocsLog inGet started
Tessl Logo

design-orchestration

Orchestrates design workflows by routing work through brainstorming, multi-agent review, and execution readiness in the correct order.

42

Quality

42%

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

Quality

Content

56%Scale 1-5

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

This is a well-structured orchestration/routing skill with a clear multi-step workflow and explicit enforcement rules. Its main weaknesses are the lack of concrete, actionable details (no examples of risk classification, no artifact templates, no invocation syntax) and some verbosity in philosophical/motivational sections that don't add operational value. The references to coordinated skills lack paths or links.

Suggestions

Add a concrete example of risk classification (e.g., a table mapping specific scenario characteristics to Low/Moderate/High risk levels) to make Step 2 actionable rather than subjective.

Provide a brief example of what an 'Understanding Lock', 'Decision Log', and 'approved design' artifact look like or where their templates live, so Claude knows what to check for.

Remove or collapse the 'Design Philosophy' and 'When to Use' sections—they add no operational value and consume tokens.

Add explicit file paths or links to the brainstorming and multi-agent-brainstorming skills so Claude can navigate to them directly.

DimensionReasoningScore

Conciseness

The skill is moderately efficient but includes some unnecessary sections like 'Design Philosophy' which restates obvious principles, and the 'Operating Model' section largely repeats what 'Purpose' already conveys. The 'When to Use' section at the end is a vacuous tautology. Several sections could be tightened.

3 / 5

Actionability

The routing logic provides a clear sequence of steps with conditions, but everything remains at an abstract/procedural level with no concrete examples of how to invoke skills, what artifacts look like, or how risk classification is actually performed. There are no executable commands, templates, or example outputs.

3 / 5

Workflow Clarity

The 5-step workflow is clearly sequenced with explicit conditions at each gate (entry conditions, risk classification, escalation rules, execution readiness check). There is a feedback loop (Step 5 blocks and returns to appropriate skill on failure). However, the risk assessment step lacks concrete criteria or a scoring rubric, making the validation checkpoint somewhat subjective.

4 / 5

Progressive Disclosure

The skill references other skills (brainstorming, multi-agent-brainstorming) but provides no links or file paths to them. There are no bundle files to support the references. The content is reasonably structured with clear sections, but for a meta-skill coordinating multiple other skills, it would benefit from explicit links to the coordinated skill files.

3 / 5

Total

13

/

20

Passed

Description

28%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 too abstract and process-oriented, relying on workflow orchestration jargon rather than concrete actions or natural user language. It lacks a 'Use when...' clause entirely, making it difficult for Claude to know when to select this skill. The description would benefit significantly from specifying concrete design tasks and explicit trigger conditions.

Suggestions

Add an explicit 'Use when...' clause with natural trigger phrases, e.g., 'Use when the user asks for design feedback, wants to brainstorm design ideas, or needs a design reviewed before implementation.'

Replace abstract process terms ('routing work', 'execution readiness') with concrete actions the skill performs, e.g., 'generates design concepts, coordinates peer reviews, produces implementation-ready design specs.'

Include natural keywords and synonyms users would actually say, such as 'design review', 'design critique', 'UI design', 'mockup', or specific design artifact types.

DimensionReasoningScore

Specificity

Names the domain (design workflows) and mentions some concepts (brainstorming, multi-agent review, execution readiness), but these are abstract process stages rather than concrete actions. No specific operations like 'creates wireframes' or 'generates design specs' are listed.

2 / 5

Completeness

The 'what' is vaguely described as orchestrating/routing design workflows through stages, but there is no 'when' clause at all. Without explicit trigger guidance ('Use when...'), completeness is capped at 3, and the weak 'what' brings it down to 2.

2 / 5

Trigger Term Quality

Terms like 'design workflows', 'brainstorming', and 'multi-agent review' are somewhat technical/process-oriented rather than natural user language. Users are unlikely to say 'orchestrate my design workflow' or 'route through execution readiness'. Missing natural trigger terms users would actually use.

2 / 5

Distinctiveness Conflict Risk

The mention of 'multi-agent review' and 'execution readiness' gives it some distinctiveness from generic design skills, but 'design workflows' and 'brainstorming' are broad enough to overlap with other design or project management skills.

3 / 5

Total

9

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-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.