agent-skill-orchestrator
This skill should be used when the user needs to solve a complex task and wants a detailed execution plan using the best available resources. Analyzes user requirements, discovers available plugins/agents/skills/MCPs, performs intelligent matching with confidence scoring, and creates strategic execution plans with alternatives. Works across all AI CLI platforms.
ericgandrade · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add ericgandrade/claude-superskills --skill agent-skill-orchestratorAbout this skill
name: agent-skill-orchestrator description: This skill should be used when the user needs to solve a complex task and wants a detailed execution plan using the best available resources. Analyzes user requirements, discovers available plugins/agents/skills/MCPs, performs intelligent matching with confidence scoring, and creates strategic execution plans with alternatives. Works across all AI CLI platforms. license: MIT
agent-skill-orchestrator
Purpose
Intelligent task planning and resource orchestration engine that analyzes user requirements and creates strategic execution plans using the best available resources. This skill performs automated discovery, intelligent matching with confidence scoring, and generates comprehensive plans with multiple options and fallback strategies.
The orchestrator operates as a planning assistant—it recommends approaches but always requests explicit user approval before execution. It serves as the intelligence layer above the discovery foundation, transforming "what do I have" into "how should I use it".
When to Use
Invoke this skill when:
- User has a complex task requiring multiple steps or resources
- User wants to know the best approach to solve a problem
- User needs coordination between multiple plugins, agents, skills, or MCPs
- User wants optimized resource utilization for a task
- User is unsure which tools or approach to use
- User needs a strategic plan before implementation
- User wants to explore multiple solution approaches
Platform Support
Works identically on all AI CLI platforms:
- Claude Code (
claude) - GitHub Copilot CLI (
gh copilot) - Gemini CLI (
gemini) - OpenCode (
opencode) - OpenAI Codex (
codex)
Progress Tracking
Display progress before each orchestration phase:
[██░░░░░░░░░░░░░░░░░░] 15% — Step 0: Discovering Available Resources
[████░░░░░░░░░░░░░░░░] 25% — Step 1: Analyzing User Request
[████████░░░░░░░░░░░░] 45% — Step 2: Intelligent Matching & Scoring
[████████████░░░░░░░░] 65% — Step 3: Generating Execution Plan
[██████████████████░░] 85% — Step 4: Presenting Plan for Approval
[████████████████████] 100% — Step 5: Plan Approved / Execution Ready
Workflow
Step -1: Prompt Quality Check (Pre-Analysis)
Objective: Ensure user request is clear and well-structured before planning.
Why This Step Matters:
- Vague prompts → poor resource matching → low-quality plans
- Optimized prompts → precise requirements → high-confidence plans
- Reduces planning iterations and "Refine plan" cycles
Prompt Quality Check: Before planning, assess whether the user request is specific enough to yield accurate resource matching. If the request is fewer than 20 words, lacks a clear action verb or goal, or uses only ambiguous references ("this", "it", "that") without context, invoke prompt-engineer to refine it first. A well-refined request improves confidence scores by 20–30% and reduces planning iterations. Proceed directly if the request is already clear.
Impact on Planning:
- ✅ Confidence scores increase 20-30%
- ✅ More accurate resource matching
- ✅ Better success criteria definition
- ✅ Reduced ambiguity in plan execution
Step 0: Discover Available Resources
Objective: Obtain fresh inventory of all installed resources.
Critical Dependency: This skill MUST call agent-skill-discovery first.
Actions:
Invoke the discovery skill to get complete resource catalog:
# Call agent-skill-discovery skill
resources = invokeSkill("agent-skill-discovery")
Expected Output:
{
"platform": "Claude Code",
"plugins": [
{
"name": "feature-dev",
"agents": [
{
"name": "code-explorer",
"description": "Analyzes existing codebase",
"tools": ["Glob", "Grep", "Read", "Bash"]
}
]
}
],
"skills": [
{
"name": "skill-creator",
"description": "Creates new skills",
"triggers": ["create a skill", "new skill"],
"category": "development"
}
],
"mcpServers": [
{
"name": "claude_ai_Notion",
"type": "stdio",
"tools": ["notion-search", "notion-create-pages"]
}
]
}
Why This Step is Critical:
- Ensures fresh, accurate resource availability
- Works across all platforms (discovery handles platform detection)
- Provides complete context for intelligent matching
- Avoids recommending unavailable resources
Step 1: Analyze User Request
Objective: Extract requirements from user's task description.
Actions:
Parse the request to extract:
- Task type — development, content, integration, analysis, documentation, or planning. Infer from verbs: build/create/implement → development; transcribe/summarize/convert → content; connect/sync/automate → integration; review/debug/diagnose → analysis; document/write → documentation; design/plan/architect → planning.
- Required capabilities — code generation, web access, file processing, external integrations (detect service names: Notion, Jira, GitHub, Slack, Confluence, browser).
- Keywords — extract nouns and technology names for matching against resource descriptions and triggers.
- Complexity — simple (single tool, one step), moderate (2–3 steps, some coordination), complex (multi-phase, dependencies between steps).
Step 2: Intelligent Matching & Scoring
Objective: Score each discovered resource against user requirements.
Score each discovered resource against the parsed requirements using five dimensions:
| Dimension | Weight | How to score |
|---|---|---|
| Trigger phrase match | 30% | Does any trigger phrase from the resource overlap with the user's keywords? |
| Semantic similarity | 25% | Does the resource description align with the user's goal and domain? |
| Tool availability | 20% | Do the resource's tools cover the required capabilities (web, file I/O, code, integrations)? |
| Cat |