Skip to content

eric-cielo/moflo / .claude/skills/spell-builder

spell-builder

Verified

Create, edit, and validate spell definitions (YAML/JSON) that compose connectors and step commands into end-to-end spells. Use when building new spell definitions, modifying existing ones, or exploring available spell components.

FileKindSize
SKILL.mdskill md12.9 KB
architecture.mdmarkdown8.5 KB
connectors/github-cli/README.mdmarkdown2.0 KB
connectors/http/README.mdmarkdown1.4 KB
connectors/local-outlook/README.mdmarkdown1.9 KB
connectors/playwright/README.mdmarkdown1.7 KB
permissions.mdmarkdown4.3 KB
preflight.mdmarkdown4.1 KB
steps/agent/README.mdmarkdown1.8 KB
steps/bash/README.mdmarkdown1005 B
steps/browser/README.mdmarkdown2.1 KB
steps/condition/README.mdmarkdown1.1 KB
steps/github/README.mdmarkdown1.6 KB
steps/loop/README.mdmarkdown1.2 KB
steps/memory/README.mdmarkdown1.6 KB
steps/outlook/README.mdmarkdown2.9 KB
steps/parallel/README.mdmarkdown1.1 KB
steps/prompt/README.mdmarkdown923 B
steps/wait/README.mdmarkdown667 B

steps/agent/README.md

View on GitHub
# `agent` — NOT EXECUTABLE

**Purpose:** Document that this step type does not work, so it is not offered when authoring a spell. It is registered but has never spawned a subagent — moflo has no agent spawner in the spell runner. Casting it always fails.

**Do not add `agent` steps to a spell.** Previously the step returned `success: true` with `result: "Agent task prepared: <type>"`, so spells containing one completed green and downstream steps consumed that string as though it were agent output. It now fails with an explanatory error instead.

The type stays registered on purpose: removing it would turn a silently-useless step into a hard parse error for any existing spell YAML that contains one.

## Use this instead

Run the Claude CLI from a `bash` step:

```yaml
- id: research
  type: bash
  config:
    command: 'claude -p "Find all REST API endpoints in src/ and list their HTTP methods and paths"'
    timeout: 300000
```

This is what moflo's own shipped spells do — see `src/cli/spells/definitions/epic-auto-merge.yaml`.

**Note on cost:** a `bash` step invoking `claude -p` has no spend ceiling, which matters most for daemon-scheduled spells. Set a `timeout` and prefer `failOnError: true`.

## If you are reading an older spell

| Old `agent` config | Replacement |
|---|---|
| `prompt` | the prompt text inside `claude -p "..."` |
| `agentType` | no equivalent — describe the role in the prompt |
| `background` | no equivalent — the bash step waits |

`model` and `systemPrompt` were documented here previously but were never implemented — the step's `configSchema` only ever accepted `prompt`, `agentType`, and `background`.

## Outputs

None. The step always fails. `agentType` and `prompt` are echoed in the failure data for diagnosis only; there is no `result`.

## Source

`src/cli/spells/commands/agent-command.ts`
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall