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".
67
58%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/09-orchestrator/SKILL.mdQuality
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-crafted description for an orchestrator/meta-skill. Its strengths are the explicit trigger terms and clear 'when to use' guidance. Its main weaknesses are that the capability descriptions remain somewhat abstract (coordinating and adapting rather than concrete actions) and some trigger terms could overlap with other development-related skills.
Suggestions
Add more concrete examples of what the orchestration produces (e.g., 'generates a step-by-step execution plan', 'produces a checklist of pipeline stages') to increase specificity.
Differentiate more clearly from CI/CD or DevOps pipeline skills by emphasizing this is about coordinating Claude's internal skill selection rather than external deployment pipelines.
| Dimension | Reasoning | Score |
|---|---|---|
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 distinguish 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 demonstrates solid domain knowledge and covers many important scenarios, but suffers from significant verbosity — it tries to be both an overview and a comprehensive reference simultaneously. The pipeline definitions and pre-execution gate are its strongest elements, providing concrete decision criteria. However, the inline volume of pipeline variations, skill descriptions, and policy restatements undermines token efficiency and could be better distributed across referenced files.
Suggestions
Move pipeline adaptation variants (bugfix, hotfix, landing page, etc.) and transversal skill descriptions to a separate file like `docs/skill-guides/pipeline-variants.md` and reference it from the main skill, keeping only the base pipeline inline.
Add explicit validation checkpoints at pipeline transitions — e.g., 'Before handoff to next skill: verify exit criteria met, artifacts produced, no open blockers' as a concrete checklist rather than prose.
Remove the anti-rationalization table and the 'Regra de Codigo Limpo' section — these restate policies already referenced and add ~30 lines of redundant content.
Add a worked example showing a complete orchestration cycle: user request → classification → pipeline selection → first handoff, to make the workflow concrete and executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~200+ lines. It over-explains pipeline variations, repeats information available in referenced policies, includes an anti-rationalization table that restates obvious principles, and documents numerous edge cases inline that could be in separate files. Much of this content (e.g., listing every possible skill and when it enters) inflates token cost significantly. | 1 / 3 |
Actionability | The skill provides concrete pipeline sequences for different task types and a structured pre-execution gate with specific signals and scoring, which is actionable. However, it lacks executable code/commands for most steps, relies heavily on references to external templates and policies without showing their content, and the ambiguity scoring formula is described but not demonstrated with a worked example. | 2 / 3 |
Workflow Clarity | The pipeline sequences are clearly listed and the protocol sections define steps for execution and between-step transitions. However, validation checkpoints are implicit rather than explicit — there's no clear 'validate before proceeding' gate at each transition, and the rejection workflow lacks a concrete feedback loop with re-validation steps. For an orchestrator managing destructive/batch-like pipeline operations, this gaps caps the score. | 2 / 3 |
Progressive Disclosure | The skill references external files well (policies/, templates/, docs/) and has a clear pointer to the orchestrator-playbook for extended scenarios. However, too much detail is kept inline — the full pipeline variations, transversal skill descriptions, and anti-rationalization table could all be in referenced files. The main SKILL.md should be a leaner overview pointing to these details. | 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
d87ad31
Table of Contents
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.