
Agent Goal Planner
Let your coding agent decompose complex goals into optimal action sequences using GOAP-style search, preconditions, and adaptive replanning.
Overview
agent-goal-planner is a journey-wide agent skill that builds GOAP-style optimal action plans with replanning—usable whenever a solo builder needs structured multi-step agent execution before committing to a brittle chat-
Install
npx skills add https://github.com/ruvnet/ruflo --skill agent-goal-plannerWhat is this skill?
- A* search over action/state spaces to minimize cost paths to objectives
- Precondition and effect modeling so agents only chain valid actions
- Adaptive replanning when execution feedback or world state changes
- Goal decomposition into sub-goals with novel action combinations
- Mixed LLM reasoning plus deterministic code actions in one plan
Adoption & trust: 648 installs on skills.sh; 58.5k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your agent keeps derailing on multi-step objectives because there is no explicit model of preconditions, effects, or how to replan when a step fails.
Who is it for?
Solo builders orchestrating complex agent runs (many tools, branching dependencies) who want gaming-AI-style GOAP instead of improvised step lists.
Skip if: Simple one-shot edits with a fully specified micro-task, or teams that forbid multi-step autonomous tool chains without human approval gates.
When should I use this skill?
Invoke with $agent-goal-planner when the objective spans multiple dependent agent actions and you need GOAP-style planning with replanning.
What do I get? / Deliverables
You get a searched action sequence toward the goal, sub-goal breakdown, and replanned paths as state changes—with clearer handoffs between LLM reasoning and code actions.
- Ordered action plan toward the stated goal
- Sub-goal decomposition with cost-aware path
- Revised plan after execution feedback or state drift
Recommended Skills
Journey fit
Useful at every journey phase - explore requirements and options before committing to a direction.
Where it fits
Break a fuzzy product idea into ordered discovery actions (research APIs, spike UI, draft pricing) with explicit preconditions.
Search for a minimum-cost sequence of codegen, test, and refactor actions to implement a multi-file feature.
Replan after a failing test step by updating effects and choosing alternate fix actions without restarting the whole chat.
Model incident states and actions (rollback, toggle flag, hotfix) and adapt the path as telemetry changes.
How it compares
Agent orchestration methodology (GOAP/search)—not a static implementation-plan template skill and not a deployment integration.
Common Questions / FAQ
Who is agent-goal-planner for?
It is for solo and indie builders using Claude Code, Cursor, Codex, or similar agents who need reliable multi-step planning across tools and code actions.
When should I use agent-goal-planner?
Use it in Validate to sequence prototype tasks, in Build for feature and integration chains, in Ship when recovery plans matter, and in Operate when incident response needs replanning—any complex objective with dependencies.
Is agent-goal-planner safe to install?
Review the Security Audits panel on this Prism page; GOAP skills can drive many tool calls—scope permissions and human checkpoints for destructive actions.
SKILL.md
READMESKILL.md - Agent Goal Planner
--- 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: 1. **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 2. **Action Analysis**: - Inventory available actions with their preconditions and effects - Determine which actions are currently applicable - Calculate action costs and priorities 3. **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 4. **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 5. **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 ```javascript // 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) } ```