# Agent

> List and invoke specialized agents

- Skill: `mgoodman60/agent` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mgoodman60/agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mgoodman60/agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: mgoodman60 (https://skillmd.com/u/mgoodman60)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mgoodman60/agent

---


Manage and invoke ForemanOS specialized agents.

## Usage

- `/agent` or `/agent list` - List all available agents
- `/agent <name>` - Show detailed help for an agent
- `/agent <name> <task>` - Invoke an agent with a task

## Available Agents

### Development Agents

| Name | Description |
|------|-------------|
| `security` | Vulnerability scanning, OWASP analysis, auth review, injection scanning |
| `tester` | Run tests, generate tests, improve coverage |
| `fixer` | Fix build errors, bugs, dependency issues |
| `documenter` | Generate documentation for code, APIs, features |
| `content-writer` | Marketing copy, feature descriptions, landing pages, changelogs |
| `database` | Prisma schema, migrations, query optimization |
| `ui` | React components, design system, accessibility |
| `ux-design` | User research, design specs, accessibility audits, user flows |

### Specialized Agents

| Name | Description |
|------|-------------|
| `stripe-expert` | Stripe payments, subscriptions, webhooks, billing |
| `pdf-specialist` | PDF processing, construction drawings, form filling |
| `refactoring-agent` | Large-scale code restructuring, pattern migrations |
| `infra-specialist` | Infrastructure, deployment, Vercel, environment config |
| `analytics-reports` | Report generation, KPI dashboards, data visualization, exports |
| `resilience-architect` | Error handling, retry strategies, graceful degradation, logging |

### Construction Domain Agents

| Name | Description |
|------|-------------|
| `project-controls` | Budget, schedule, EVM, cash flow, variance reports |
| `quantity-surveyor` | Takeoffs, pricing, symbol recognition, bid analysis |
| `document-intelligence` | OCR, RAG, document extraction, contract analysis |
| `field-operations` | Daily reports, labor tracking, weather delays |
| `data-sync` | Cross-system sync, cascade updates, data flow |
| `submittal-tracker` | Submittals, RFIs, spec compliance tracking |
| `compliance-checker` | Permits, inspections, OSHA, closeout docs |
| `bim-specialist` | Autodesk/BIM integration, clash detection, model data |
| `photo-analyst` | Field photo analysis, progress tracking, safety checks |

## Examples

```
/agent list
/agent security
/agent fixer Fix the TypeScript errors in lib/rag.ts
/agent tester Generate tests for the new budget sync feature
/agent quantity-surveyor Extract quantities from the uploaded floor plan
```

## How to Invoke

When the user specifies an agent and task:

1. Use the **Task tool** with `subagent_type` set to the agent name
2. Pass the task description as the `prompt` parameter
3. Set `run_in_background: true` for long-running tasks

Example invocation:
```
Task tool:
  subagent_type: "fixer"
  prompt: "Fix the TypeScript errors in lib/rag.ts"
  description: "Fix TS errors in rag.ts"
```

## Agent Details

To see full details about an agent, read its definition file:
- `.claude/agents/<agent-name>.md`

## Auto-Routing

Agents are also automatically selected based on keywords in user queries:
- "security audit" → security agent
- "run tests" → tester agent
- "fix bug" → fixer agent
- "generate docs" → documenter agent
- "takeoff" → quantity-surveyor agent
- "clash detection" → bim-specialist agent
- "UX audit", "user flow", "WCAG" → ux-design agent
- "report", "KPI", "dashboard", "analytics" → analytics-reports agent
- "error handling", "retry", "circuit breaker" → resilience-architect agent