
- Installs
- 1.1K
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/ruvnet/ruflo --skill agent-goal-planner- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads agent-goal-planner automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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)
}
FAQ
What does the agent-goal-planner skill do?
Agent skill for goal-planner - invoke with $agent-goal-planner
How do I install agent-goal-planner?
Run npx skills add https://github.com/ruvnet/ruflo --skill agent-goal-planner in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/agent-goal-planner/ (personal) or .claude/skills/agent-goal-planner/ (project).
Which AI agents can use agent-goal-planner?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is agent-goal-planner safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains agent-goal-planner?
It is published by ruvnet in ruvnet/ruflo. It has 1,137 recorded installs.
More from ruvnet/ruflo
swarm-orchestration
ruvnet/ruflo
Multi-agent swarm coordination for complex tasks. Uses hierarchical topology with specialized agents to break down and execute complex work across multiple files and modules. Use when: 3+ files need changes, new feature implementation, cross-module refactoring, API changes with tests, security-related changes, performance optimization across codebase, database schema changes. Skip when: single file edits, simple bug fixes (1-2 lines), documentation updates, configuration changes, quick exploration.
agent-arch-system-design
ruvnet/ruflo
Agent skill for arch-system-design - invoke with $agent-arch-system-design
agent-workflow
ruvnet/ruflo
Agent skill for workflow - invoke with $agent-workflow
security-audit
ruvnet/ruflo
Comprehensive security scanning and vulnerability detection. Includes input validation, path traversal prevention, CVE detection, and secure coding pattern enforcement. Use when: authentication implementation, authorization logic, payment processing, user data handling, API endpoint creation, file upload handling, database queries, external API integration. Skip when: read-only operations on public data, internal development tooling, static documentation, styling changes.
github-project-management
ruvnet/ruflo
Comprehensive GitHub project management with swarm-coordinated issue tracking, project board automation, and sprint planning
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.