Skip to content
cccskills
FreePublished on GitHubEnglish overview

agent-goal-planner

Turn complex goals into actionable steps by examining requirements, expected effects, and costs. Build a path from the current situation to the desired outcome, then revise the plan when actions fail or conditions change.

OriginalShow the original description

Agent skill for goal-planner - invoke with $agent-goal-planner

AI rating80/ 100See how to install

Good for

  • Breaking a complex goal into smaller tasks
  • Planning steps around dependencies and costs
  • Replanning after failures or changing conditions
  • Matching planned actions to available tools

Overview

What it does

This skill examines the gap between the current situation and a complex goal, then arranges the actions needed to reach it. It uses GOAP, a method from game AI for planning actions around goals. For each action, it considers prerequisites, expected effects, and execution costs. It compares possible action sequences using A* search and builds a plan around the tools available.

When it helps

Use it for work with many dependencies, especially when it is unclear where to start. It helps break a goal into smaller tasks and rebuild the sequence after a failure, new information, or a change in conditions. Its workflow also covers observing execution results and updating the plan as work proceeds.

Example requests

  • “Plan the work needed for production deployment, taking prerequisites and costs into account.”
  • “This task failed. Rebuild the steps from the current situation to the goal.”

Notes

Invoke it with $agent-goal-planner. The documentation includes integration examples using mcp__claude-flow__ tools. Running those examples requires a compatible MCP environment.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodThe material explicitly describes decomposing complex goals, analyzing prerequisites, and replanning after failures.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodFive stages from state assessment to replanning are described, with MCP integration examples including arguments.
SafetyAre sending data, deleting files, and running commands disclosed?
BPartly lackingExamples include task execution and saving plans to memory, but no checks before execution are specified.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIntegration examples use mcp__claude-flow__, but MCP environment setup instructions are absent.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 21, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (1)

  • SKILL.md3.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.


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)
}

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

add-model-descriptions

FreeSummaryAI rating 80

Compare models available through the HuggingFace router with chat-ui configuration, research missing models, and write short English descriptions of their architecture and capabilities. Add entries to both production and development configuration files and commit the changes.

  • Adding newly available router models to chat-ui
  • Writing concise descriptions of model capabilities
  • Updating production and development model entries together
ruvnet/ruflo78KUpdated Oct 20, 2026

adr-create

FreeSummaryAI rating 80

Create an Architecture Decision Record, a document for recording important design choices, with the next sequential number. It generates a Markdown template, registers the record in AgentDB, and links related decisions found through search.

  • Record the reasoning behind adopting a technology
  • Start an ADR for an API or data model change
  • Document an infrastructure decision
ruvnet/ruflo78KUpdated Oct 20, 2026

adr-index

FreeSummary

Build a searchable index and relationship graph from ADRs, records of architectural decisions. Import two supported document formats, refresh existing metadata without duplicate relationships, and review summaries of statuses, missing references, and inconsistencies.

  • Index ADRs imported from another project
  • Refresh a graph that differs from files on disk
  • Set up ADR tracking in an existing codebase
ruvnet/ruflo78KUpdated Oct 20, 2026

adr-reindex

FreeSummaryAI rating 70

Rebuild the index of ADRs, records of architectural decisions, after files or relationship lines are deleted. It clears stored records and relationships, indexes the files still present, and checks that the final record count matches.

  • Rebuild the index after deleting an ADR file
  • Remove stale relationships after editing an ADR
  • Reconcile the ADR index on a schedule
ruvnet/ruflo78KUpdated Oct 20, 2026

adr-review

FreeSummaryAI rating 80

Review code changes against accepted Architecture Decision Records, documents that capture agreed design choices. Report violations, outdated references, compliant changes, and areas without ADR coverage, then suggest code fixes or a new decision record where appropriate.

  • Check a pull request before merging
  • Review major code changes against agreed design decisions
  • Find references to superseded ADRs
ruvnet/ruflo78KUpdated Oct 20, 2026

adr-verify

FreeSummaryAI rating 90

Check saved architecture decision records (ADRs) for broken references, circular replacement relationships, and inconsistent statuses. Use the results to verify imported records or stop a CI check when selected integrity rules fail.

  • Checking ADR integrity after import
  • Blocking CI when ADR issues are found
  • Reviewing ADR data before a release
ruvnet/ruflo78KUpdated Oct 20, 2026

See all skills by ruvnet

Report a problem with this skill