
Agent Goal Planner
- 1k installs
- 67k repo stars
- Updated August 4, 2026
- ruvnet/ruflo
agent-goal-planner is an agent skill that uses Goal-Oriented Action Planning to generate adaptive multi-step action sequences for developers who need agents to achieve complex objectives by combining available tools.
About
agent-goal-planner is an advanced ruflo agent skill that applies Goal-Oriented Action Planning (GOAP)—gaming AI techniques—for developers whose agents must achieve complex objectives through creative tool combinations. The Goal-Oriented Action Planning specialist dynamically creates optimal action sequences, excels at adaptive replanning when state changes, and searches complex state spaces for novel solutions beyond fixed scripts. Invoke it with $agent-goal-planner when tasks require multi-step reasoning, tool chaining, or recovery after failed intermediate steps. The skill discovers paths by evaluating preconditions and effects across available actions rather than following a single hard-coded workflow. Reach for agent-goal-planner when objectives are underspecified, environments shift mid-run, or agents must replan after partial failures.
- Dynamic A* search for optimal paths through state spaces
- Adaptive replanning based on execution results and changing conditions
- Goal decomposition that breaks complex objectives into achievable sub-goals
- Cost optimization and precondition/effect modeling for every action
- Mixed execution blending LLM reasoning with deterministic code actions
Agent Goal Planner by the numbers
- 1,015 all-time installs (skills.sh)
- +5 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #471 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ruvnet/ruflo --skill agent-goal-plannerAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1k |
|---|---|
| repo stars | ★ 67k |
| Security audit | 3 / 3 scanners passed |
| Last updated | August 4, 2026 |
| Repository | ruvnet/ruflo ↗ |
How do AI agents plan multi-step tool sequences for complex goals?
Generate intelligent, adaptive action sequences that achieve complex objectives by creatively combining available tools and steps.
Who is it for?
Developers whose agents face complex, changing objectives requiring dynamic tool chaining, replanning, and state-space search instead of fixed scripts.
Skip if: Single-tool one-shot tasks or workflows with a fixed linear checklist that never changes mid-run.
When should I use this skill?
The user states a complex objective, agents need adaptive replanning, or available tools must be combined creatively across multiple steps.
What you get
GOAP action plans, precondition/effect chains, adaptive replans, and ordered tool invocation sequences toward the stated objective.
- GOAP action plan
- Tool invocation sequence
- Adaptive replan on failure
Files
--- 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
// 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)
}Related skills
How it compares
Pick this over static task lists when objectives change mid-run and agents must replan tool sequences using GOAP state-space search.
FAQ
What planning approach does agent-goal-planner use?
agent-goal-planner uses Goal-Oriented Action Planning (GOAP), a gaming-AI technique that searches preconditions and effects to build adaptive multi-step action sequences toward complex objectives.
When should developers invoke agent-goal-planner?
Invoke agent-goal-planner with $agent-goal-planner when objectives need creative tool combinations, multi-step reasoning, or adaptive replanning after failed or changed intermediate states.
How is agent-goal-planner different from fixed workflows?
agent-goal-planner discovers novel action paths through state-space search and replans dynamically, unlike fixed workflows that execute the same predetermined step list every run.
Is Agent Goal Planner safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.