CtrlK
BlogDocsLog inGet started
Tessl Logo

oma-orchestrator

Automated multi-agent orchestrator that spawns CLI subagents in parallel, coordinates via MCP Memory, and monitors progress. Use for orchestration, parallel execution, and automated multi-agent workflows.

60

Quality

70%

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 ./benchmarks/runs/oma/.agents/skills/oma-orchestrator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

66%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 is impressively rigorous on process: an explicit multi-phase workflow with a three-stage verify/cross-review feedback loop, loop limits, retries, and configuration defaults. Its weaknesses are duplicated structural sections and abstract SSL-primitive tables that waste tokens, and — most seriously — a reference graph whose files (resources/, config/, templates/, _shared/) largely do not exist in the provided bundle, undermining the progressive-disclosure design.

Suggestions

Fix the reference graph: either ship the referenced files (resources/subagent-prompt-template.md, resources/memory-schema.md, config/cli-config.yaml, templates/, ../_shared/core/*) in the bundle or remove/inline the pointers so no navigation path dead-ends.

Deduplicate 'Structural Flow' and 'Workflow Phases' into one sequence, and delete the 'Logical Operations' SSL-primitive and 'Intent signature' scaffolding that restates the description — this would materially tighten token efficiency.

Move the Clarification Debt monitoring protocol and the review feedback format into a reference file (e.g., the already-cited session-metrics.md) so SKILL.md stays a lean overview.

DimensionReasoningScore

Conciseness

Mostly tabular and terse, but contains clear slack: the 'Structural Flow' scenes (PREPARE/ACT/VERIFY/RECOVER/FINALIZE) duplicate the 'Workflow Phases' (PHASE 1-5), the 'Logical Operations' SSL-primitive table (READ/WRITE/CALL_TOOL...) is abstract bookkeeping that adds no executable value, and the 'Scheduling' intent-signature section restates the frontmatter description. Not 2 because there is no padding that explains concepts Claude already knows and most sections are dense and useful.

3 / 5

Actionability

Provides concrete, executable commands ('oma agent:spawn <agent-type> "<task>" <session-id> -w <workspace>', 'oma verify ... --json', 'claude --agent <agent>'), a defaults table (MAX_PARALLEL=3, MAX_RETRIES=2, POLL_INTERVAL=30s), a complete mcp.json example, loop-limit tables, and a ready-to-use review feedback template. Not 5 because key operational detail is delegated to files that do not exist in the bundle (e.g., 'resources/subagent-prompt-template.md' for prompt construction) and the 'oh-my-ag agent:spawn' fallback never gets a full invocation example.

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced (Entry -> Scenes -> Transitions -> Failure/recovery -> Exit, plus PHASE 1-5) with explicit validation checkpoints and a drawn feedback loop: mechanical self-check -> 'oma verify' (exit 0/1 handling) -> QA cross-review, with FAIL paths feeding fixes back, explicit loop limits, and a tiered retry policy. This matches the top anchor including feedback loops for error recovery and checklists for a complex process.

5 / 5

Progressive Disclosure

Judged against the actual bundle: only 'scripts/spawn-agent.sh', 'scripts/parallel-run.sh', and 'scripts/verify.sh' exist, while the body's references to 'resources/subagent-prompt-template.md', 'resources/memory-schema.md', 'config/cli-config.yaml', 'templates/', and all '../_shared/core/*' paths point to files absent from the bundle, breaking navigation. Additionally, detailed material that clearly belongs in separate files (the full CD monitoring protocol, the review-loop spec, the review feedback format) is inlined. Not 1 because references are one level deep and clearly signaled rather than nested or buried, and the SKILL.md does function as an overview.

2 / 5

Total

14

/

20

Passed

Description

75%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 in third person that states both capability and an explicit 'Use for...' clause. It sits comfortably above the midpoint on all dimensions but stops short of the top anchors: capability coverage is incomplete relative to what the skill does, and trigger guidance uses category nouns rather than concrete user phrases.

Suggestions

Add concrete trigger phrases users would actually say, e.g., "Use when the user says 'run it automatically', 'run these tasks in parallel', or asks to coordinate multiple agents end to end."

Mention 1-2 more differentiating capabilities (task decomposition, automated verify/QA cross-review loop) to round out the 'what' and sharpen distinctiveness from generic coordination skills.

DimensionReasoningScore

Specificity

Names the domain ('multi-agent orchestrator') and several concrete actions — 'spawns CLI subagents in parallel, coordinates via MCP Memory, and monitors progress' — which matches 'several specific actions; minor gaps in coverage'. Not 5 because major capabilities from the body (task decomposition, verification/QA review loop, retries, result collection) are absent; not 3 because more than 1-2 concrete actions are listed.

4 / 5

Completeness

Explicitly answers both: what ('spawns CLI subagents in parallel, coordinates via MCP Memory, and monitors progress') and when ('Use for orchestration, parallel execution, and automated multi-agent workflows'). Not 5 because the 'when' clause lacks concrete trigger phrases users would actually utter (e.g., 'when the user says run it automatically'); not 3 because both what and when are explicitly present.

4 / 5

Trigger Term Quality

'Use for orchestration, parallel execution, and automated multi-agent workflows' gives good natural keyword coverage a user would plausibly say. Not 5 because common variations and synonyms are missing (e.g., 'spawn agents', 'run it automatically', 'coordinate agents'); not 3 because the included terms are natural and relevant rather than missing variations.

4 / 5

Distinctiveness Conflict Risk

Multi-agent orchestration with CLI subagents and MCP Memory coordination is a clear, mostly distinct niche with trigger terms unlikely to fire for unrelated skills. Not 5 because it could overlap with sibling coordination skills (the body itself references a separate 'oma-coordination' skill) and generic 'orchestration' requests; not 3 because the described mechanism is fairly specific.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
first-fluke/oh-my-agent
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.