CtrlK
BlogDocsLog inGet started
Tessl Logo

orchestrator

Skill do Tech Lead/Orquestrador do pipeline de desenvolvimento. Deve ser usada no inicio de toda task e entre etapas relevantes do pipeline. Coordena qual skill executar, em que ordem, adapta o fluxo ao contexto, garante que nenhuma etapa critica seja pulada e mantem visao geral do progresso. Trigger em: "nova task", "iniciar", "pipeline", "orquestrar", "coordenar", "planejar execucao", "proximo passo", "workflow".

53

Quality

58%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/09-orchestrator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

82%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a reasonably well-constructed description for an orchestrator/meta-skill. Its strengths are the explicit trigger terms and clear articulation of both what it does and when to use it. Its main weaknesses are that the capabilities described are somewhat abstract (coordination, adaptation) rather than concrete actions, and some trigger terms could overlap with other development-related skills.

Suggestions

Make capabilities more concrete by specifying what pipeline stages are coordinated (e.g., 'Coordinates code review, testing, deployment, and documentation skills in sequence')

Add distinctiveness by clarifying this is a meta-skill that delegates to other skills, distinguishing it from CI/CD pipeline or project planning skills

DimensionReasoningScore

Specificity

The description names the domain (Tech Lead/Orchestrator of development pipeline) and describes some actions like coordinating which skill to execute, adapting flow to context, and ensuring no critical step is skipped. However, the actions are somewhat abstract ('coordena qual skill executar', 'mantém visão geral do progresso') rather than listing concrete, specific operations.

2 / 3

Completeness

The description clearly answers both 'what' (coordinates skill execution order, adapts flow to context, ensures no critical step is skipped, maintains progress overview) and 'when' (at the start of every task and between relevant pipeline stages), with explicit trigger terms listed.

3 / 3

Trigger Term Quality

The description includes a good set of natural trigger terms that users would actually say: 'nova task', 'iniciar', 'pipeline', 'orquestrar', 'coordenar', 'planejar execução', 'próximo passo', 'workflow'. These cover multiple natural variations of how a user might invoke this skill.

3 / 3

Distinctiveness Conflict Risk

While the orchestrator/tech lead role is somewhat distinct, terms like 'planejar execução', 'próximo passo', and 'coordenar' could overlap with project management or planning skills. The meta-skill nature (coordinating other skills) helps differentiate it, but 'pipeline' and 'workflow' could conflict with CI/CD or DevOps skills.

2 / 3

Total

10

/

12

Passed

Implementation

35%

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

This orchestrator skill attempts to be comprehensive but suffers from severe verbosity, content duplication (the Constituicao section appears twice verbatim), and poor content splitting — it inlines extensive detail that should live in referenced files while simultaneously pointing to those files. The actionability is moderate with some concrete examples but too much descriptive prose. The workflow has reasonable structure but lacks explicit validation checkpoints.

Suggestions

Remove the duplicated 'Constituicao (se existir)' section and deduplicate any other repeated content throughout the file.

Move the detailed vertical slicing examples, model routing table, and image generator invocation details into their respective referenced files (policies/vertical-slices.md, policies/model-routing-real.md, skills/17-image-generator/SKILL.md) and keep only 1-2 line summaries with links in this SKILL.md.

Add explicit validation checkpoints to the workflow (e.g., 'After classification: confirm pipeline with user before proceeding', 'After each slice completes: verify acceptance criteria before merging') rather than the vague 'verificar criterios de saida'.

Reduce the Pipeline Base section to a concise table or short list, moving the detailed descriptions of when each transversal skill activates into a separate reference file.

DimensionReasoningScore

Conciseness

The skill is extremely verbose (~400+ lines) with significant redundancy: the 'Constituicao' section is duplicated verbatim, policies are listed but not actionable, and extensive explanations of concepts Claude already understands (what vertical slicing is, what a pipeline is). Many sections repeat information available in referenced policies. The anti-rationalization table and model routing table add bulk that belongs in referenced files.

1 / 3

Actionability

The skill provides some concrete guidance (pipeline sequences, code examples for Agent dispatch, ambiguity score formula, bypass signals list) but much of it is descriptive rather than executable. The pipeline adaptation section lists patterns but doesn't give precise decision trees. The pre-execution gate has a scoring formula but no concrete implementation. The Agent dispatch example is helpful but surrounded by verbose context.

2 / 3

Workflow Clarity

The two pipeline modes (A and B) are clearly distinguished with a decision table, and the base pipeline sequence is defined. However, validation checkpoints between steps are implicit ('verificar criterios de saida') rather than explicit with concrete checks. The rejection workflow mentions steps but lacks a clear feedback loop with specific validation criteria. Missing explicit 'stop and verify' gates for destructive or batch operations like parallel slice dispatch.

2 / 3

Progressive Disclosure

The skill references many external files (policies/, templates/, programs/, docs/) which is good progressive disclosure in principle, but the SKILL.md itself is a monolithic wall of text that inlines too much detail that should live in those referenced files. The vertical slicing section, model routing table, image generator details, and parallelization examples are all lengthy inline content that could be in separate guides. References exist but the split between inline and referenced content is poorly balanced.

2 / 3

Total

7

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
felvieira/claude-skills-fv
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.