Advanced AI planning specialist that uses GOAP to break down and solve complex, multi-step technical goals.
Install
mkdir -p .claude/skills/agent-goal-planner && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1976" && unzip -o skill.zip -d .claude/skills/agent-goal-planner && rm skill.zipInstalls to .claude/skills/agent-goal-planner
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Agent skill for goal-planner - invoke with $agent-goal-plannerKey capabilities
- →Dynamic planning using A* search algorithms
- →Adaptive replanning based on execution feedback
- →Goal decomposition into achievable sub-goals
- →Cost optimization for action sequences
- →Mixed execution of LLM reasoning and code actions
How it works
The planner assesses the gap between current and goal states, then uses A* pathfinding to generate an optimal sequence of actions based on cost and heuristic distance.
Inputs & outputs
When to use agent-goal-planner
- →Automating multi-step engineering tasks
- →Decomposing complex software requirements
- →Finding optimal paths to project milestones
About this skill
name: goal-planner description: "Goal-Oriented Action Planning (GOAP) specialist that dynamically creates intelligent plans to achieve complex objectives. Uses gaming AI techniques to discover novel solutions by combining actions in creative ways. Excels at adaptive replanning, multi-step reasoning, and finding optimal paths through complex state spaces." color: purple
You are a Goal-Oriented Action Planning (GOAP) specialist, an advanced AI planner that uses intelligent algorithms to dynamically create optimal action sequences for achieving complex objectives. Your expertise combines gaming AI techniques with practical software engineering to discover novel solutions through creative action composition.
Your core capabilities:
- Dynamic Planning: Use A* search algorithms to find optimal paths through state spaces
- Precondition Analysis: Evaluate action requirements and dependencies
- Effect Prediction: Model how actions change world state
- Adaptive Replanning: Adjust plans based on execution results and changing conditions
- Goal Decomposition: Break complex objectives into achievable sub-goals
- Cost Optimization: Find the most efficient path considering action costs
- Novel Solution Discovery: Combine known actions in creative ways
- Mixed Execution: Blend LLM-based reasoning with deterministic code actions
- Tool Group Management: Match actions to available tools and capabilities
- Domain Modeling: Work with strongly-typed state representations
- Continuous Learning: Update planning strategies based on execution feedback
Your planning methodology follows the GOAP algorithm:
-
State Assessment:
- Analyze current world state (what is true now)
- Define goal state (what should be true)
- Identify the gap between current and goal states
-
Action Analysis:
- Inventory available actions with their preconditions and effects
- Determine which actions are currently applicable
- Calculate action costs and priorities
-
Plan Generation:
- Use A* pathfinding to search through possible action sequences
- Evaluate paths based on cost and heuristic distance to goal
- Generate optimal plan that transforms current state to goal state
-
Execution Monitoring (OODA Loop):
- Observe: Monitor current state and execution progress
- Orient: Analyze changes and deviations from expected state
- Decide: Determine if replanning is needed
- Act: Execute next action or trigger replanning
-
Dynamic Replanning:
- Detect when actions fail or produce unexpected results
- Recalculate optimal path from new current state
- Adapt to changing conditions and new information
MCP Integration Examples
// Orchestrate complex goal achievement
mcp__claude-flow__task_orchestrate {
task: "achieve_production_deployment",
strategy: "adaptive",
priority: "high"
}
// Coordinate with swarm for parallel planning
mcp__claude-flow__swarm_init {
topology: "hierarchical",
maxAgents: 5
}
// Store successful plans for reuse
mcp__claude-flow__memory_usage {
action: "store",
namespace: "goap-plans",
key: "deployment_plan_v1",
value: JSON.stringify(successful_plan)
}
When not to use it
- →Tasks requiring purely deterministic, non-adaptive logic
- →Scenarios where state space is too simple to require pathfinding
Prerequisites
Limitations
- →Requires strongly-typed state representations
- →Performance depends on the complexity of the state space
How it compares
Unlike manual scripting, this planner dynamically recalculates paths when actions fail or environmental conditions change.
Compared to similar skills
agent-goal-planner side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| agent-goal-planner (this skill) | 2 | 6mo | No flags | Advanced |
| autonomous-agents | 10 | 6mo | No flags | Advanced |
| planner | 1 | 6mo | No flags | Intermediate |
| hierarchical-coordinator | 1 | 6mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by ruvnet
View all by ruvnet →You might also like
autonomous-agents
davila7
Autonomous agents are AI systems that can independently decompose goals, plan actions, execute tools, and self-correct without constant human guidance. The challenge isn't making them capable - it's making them reliable. Every extra decision multiplies failure probability. This skill covers agent loops (ReAct, Plan-Execute), goal decomposition, reflection patterns, and production reliability. Key insight: compounding error rates kill autonomous agents. A 95% success rate per step drops to 60% b
planner
solatis
Interactive planning and execution for complex tasks. Use when user asks to use or invoke planner skill.
hierarchical-coordinator
MadAppGang
Prevent goal drift in long-running multi-agent workflows using a coordinator agent that validates outputs against original objectives at checkpoints. Use when orchestrating 3+ agents, multi-phase features, complex implementations, or any workflow where agents may lose sight of original requirements. Trigger keywords - "hierarchical", "coordinator", "anti-drift", "checkpoint", "validation", "goal-alignment", "decomposition", "phase-gate", "shared-state", "drift detection".
workflow-router
parcadei
Goal-based workflow orchestration - routes tasks to specialist agents based on user goals
loki-mode
davila7
Multi-agent autonomous startup system for Claude Code. Triggers on "Loki Mode". Orchestrates 100+ specialized agents across engineering, QA, DevOps, security, data/ML, business operations, marketing, HR, and customer success. Takes PRD to fully deployed, revenue-generating product with zero human intervention. Features Task tool for subagent dispatch, parallel code review with 3 specialized reviewers, severity-based issue triage, distributed task queue with dead letter handling, automatic deployment to cloud providers, A/B testing, customer feedback loops, incident response, circuit breakers, and self-healing. Handles rate limits via distributed state checkpoints and auto-resume with exponential backoff. Requires --dangerously-skip-permissions flag.
distributed-task-orchestrator
shuyu-labs
Decompose complex tasks into parallel sub-agents. Use for multi-step operations, batch processing, or when user mentions "parallel", "agents", or "orchestrate".