How do I install the Goap Agent skill?

Run npx get-skill add tomevault-io/goap-agent in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Goap Agent safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Goap Agent?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Goap Agent free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Goap Agent?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Goap Agent by tomevault-io — Agent Skill

Name: Goap Agent
Author: tomevault-io

Goap Agent

Invoke for complex multi-step tasks requiring intelligent planning and multi-agent coordination. Use when tasks need decomposition, dependency mapping, parallel/sequential/swarm/iterative execution strategies, or coordination of multiple specialized agents. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

GOAP Agent Skill

Goal-Oriented Action Planning for complex multi-step tasks with intelligent planning and multi-agent coordination.

Quick Reference

Methodology - Core GOAP planning cycle and phases
Execution Strategies - Parallel, Sequential, Swarm, Hybrid patterns
Skills Reference - Available skills by category
Agents Reference - Available task agents and capabilities
Patterns - Common GOAP execution patterns
Examples - Complete GOAP workflow examples
ADR-022 - Architecture Decision Record

When to Use

Complex multi-step tasks (5+ distinct steps)
Cross-domain problems (storage, API, testing, documentation)
Tasks requiring parallel/sequential execution
Quality-critical work with validation checkpoints
Large refactors or architectural changes

CRITICAL: Skills vs Task Agents

Skills (via Skill tool): Instruction sets that guide Claude directly Agents (via Task tool): Autonomous sub-processes that execute tasks

Example:

WRONG: Task(subagent_type="rust-code-quality", ...) → ERROR!
CORRECT: Skill(command="rust-code-quality") → SUCCESS

See skills.md for complete skills list and agents.md for agent capabilities.

Core Process

ANALYZE → Understand goals, constraints, resources
- Check ADRs: Read relevant ADRs from plans/adr/ before planning
DECOMPOSE → Break into atomic tasks with dependencies
STRATEGIZE → Choose execution pattern
COORDINATE → Assign to specialized agents
EXECUTE → Run with monitoring and quality gates
SYNTHESIZE → Aggregate results and validate success

PR Monitoring Guardrail

During EXECUTE/SYNTHESIZE for PR work, always verify statusCheckRollup on the latest head SHA.
Treat an empty required-check rollup as a blocker and document it in plans/STATUS/VALIDATION_LATEST.md.
Avoid adding plans-only follow-up commits until remediation checks are attached.

See methodology.md for detailed phase-by-phase guidance and patterns.md for common execution patterns.

ADR Integration Workflow

MANDATORY: Always check ADRs in plans/adr/ before creating execution plans:

Step 1: ADR Discovery

# List all ADRs to identify relevant ones
ls plans/adr/ADR-*.md

Step 2: Read Relevant ADRs

Search for ADRs related to your task domain
Note architectural decisions and constraints
Check ADR status (Accepted/Implemented vs Deprecated)

Step 3: Incorporate into Planning

Use ADR constraints when decomposing tasks
Reference ADRs in execution plans
Ensure compliance with architectural decisions

Step 4: Update Progress in plans/

Create/update execution plan files in plans/
Document progress, blockers, and decisions
Link to relevant ADRs in plan files

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: goap-agentdescription: Invoke for complex multi-step tasks requiring intelligent planning and multi-agent coordination. Use when tasks need decomposition, dependency mapping, parallel/sequential/swarm/iterative execution strategies, or coordination of multiple specialized agents. Use when this capability is needed.---# GOAP Agent SkillGoal-Oriented Action Planning for complex multi-step tasks with intelligent planning and multi-agent coordination.## Quick Reference- **[Methodology](methodology.md)** - Core GOAP planning cycle and phases- **[Execution Strategies](execution-strategies.md)** - Parallel, Sequential, Swarm, Hybrid patterns- **[Skills Reference](skills.md)** - Available skills by category- **[Agents Reference](agents.md)** - Available task agents and capabilities- **[Patterns](patterns.md)** - Common GOAP execution patterns- **[Examples](examples.md)** - Complete GOAP workflow examples- **[ADR-022](../../../plans/adr/ADR-022-GOAP-Agent-System.md)** - Architecture Decision Record## When to Use- Complex multi-step tasks (5+ distinct steps)- Cross-domain problems (storage, API, testing, documentation)- Tasks requiring parallel/sequential execution- Quality-critical work with validation checkpoints- Large refactors or architectural changes## CRITICAL: Skills vs Task Agents**Skills** (via `Skill` tool): Instruction sets that guide Claude directly**Agents** (via `Task` tool): Autonomous sub-processes that execute tasksExample:- WRONG: `Task(subagent_type="rust-code-quality", ...)` → ERROR!- CORRECT: `Skill(command="rust-code-quality")` → SUCCESSSee **[skills.md](skills.md)** for complete skills list and **[agents.md](agents.md)** for agent capabilities.## Core Process1. **ANALYZE** → Understand goals, constraints, resources - **Check ADRs**: Read relevant ADRs from `plans/adr/` before planning2. **DECOMPOSE** → Break into atomic tasks with dependencies3. **STRATEGIZE** → Choose execution pattern4. **COORDINATE** → Assign to specialized agents5. **EXECUTE** → Run with monitoring and quality gates6. **SYNTHESIZE** → Aggregate results and validate success## PR Monitoring Guardrail- During EXECUTE/SYNTHESIZE for PR work, always verify `statusCheckRollup` on the latest head SHA.- Treat an empty required-check rollup as a blocker and document it in `plans/STATUS/VALIDATION_LATEST.md`.- Avoid adding plans-only follow-up commits until remediation checks are attached.See **[methodology.md](methodology.md)** for detailed phase-by-phase guidance and **[patterns.md](patterns.md)** for common execution patterns.## ADR Integration Workflow**MANDATORY**: Always check ADRs in `plans/adr/` before creating execution plans:### Step 1: ADR Discovery```bash# List all ADRs to identify relevant onesls plans/adr/ADR-*.md```### Step 2: Read Relevant ADRs- Search for ADRs related to your task domain- Note architectural decisions and constraints- Check ADR status (Accepted/Implemented vs Deprecated)### Step 3: Incorporate into Planning- Use ADR constraints when decomposing tasks- Reference ADRs in execution plans- Ensure compliance with architectural decisions### Step 4: Update Progress in plans/- Create/update execution plan files in `plans/`- Document progress, blockers, and decisions- Link to relevant ADRs in plan files---> Converted and distributed by [TomeVault](https://tomevault.io/claim/d-o-hub) — claim your Tome and manage your conversions.

Frequently asked questions