eric-cielo/moflo / .claude/skills/spell-builder
spell-builder
VerifiedCreate, 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.9 KB |
| architecture.md | markdown | 8.5 KB |
| connectors/github-cli/README.md | markdown | 2.0 KB |
| connectors/http/README.md | markdown | 1.4 KB |
| connectors/local-outlook/README.md | markdown | 1.9 KB |
| connectors/playwright/README.md | markdown | 1.7 KB |
| permissions.md | markdown | 4.3 KB |
| preflight.md | markdown | 4.1 KB |
| steps/agent/README.md | markdown | 1.8 KB |
| steps/bash/README.md | markdown | 1005 B |
| steps/browser/README.md | markdown | 2.1 KB |
| steps/condition/README.md | markdown | 1.1 KB |
| steps/github/README.md | markdown | 1.6 KB |
| steps/loop/README.md | markdown | 1.2 KB |
| steps/memory/README.md | markdown | 1.6 KB |
| steps/outlook/README.md | markdown | 2.9 KB |
| steps/parallel/README.md | markdown | 1.1 KB |
| steps/prompt/README.md | markdown | 923 B |
| steps/wait/README.md | markdown | 667 B |
permissions.md
View on GitHub# Spell Permissions — Disclosure & Dry-Run Reporting
Purpose: when authoring or modifying a spell, you MUST surface what each step is allowed to do **before** the spell becomes runnable. This file is the canonical reference for that behaviour and is shared by the `spell-builder` and `connector-builder` skills.
## Permission Levels
Levels control which Claude CLI tools a step's sub-agent receives. Auto-derived from declared `capabilities` unless the step sets `permissionLevel:` explicitly. `autonomous` is never auto-derived — it requires explicit opt-in.
| Level | Tools | Auto-derived when |
|-------|-------|-------------------|
| `readonly` | Read, Glob, Grep | Only `fs:read`, `memory` capabilities |
| `standard` | Edit, Write, Read, Glob, Grep | Has `fs:write` or `agent`, no `shell`/`browser` |
| `elevated` | Edit, Write, Bash, Read, Glob, Grep | Has `shell` or `browser` |
| `autonomous` | All tools | Never auto — explicit opt-in only |
## Risk Classification
| Class | Triggered by | Meaning |
|-------|--------------|---------|
| `[SAFE]` | `fs:read`, `memory` only | No side effects |
| `[SENSITIVE]` | `agent`, `net`, `browser` | Reads external data or spawns processes |
| `[DESTRUCTIVE]` | `shell`, `fs:write`, `browser:evaluate`, `credentials` | Can permanently modify or delete data |
## Capability Warnings
For each destructive or sensitive capability declared on a step, include the matching warning in disclosure output:
| Capability | Warning text |
|------------|--------------|
| `shell` | "Can execute arbitrary shell commands (rm, git push, etc.)" |
| `fs:write` | "Can create, overwrite, or delete files on disk" |
| `credentials` | "Can access stored secrets and API keys" |
| `agent` | "Can spawn autonomous Claude sub-agents" |
| `net` | "Can make network requests to external services" |
| `browser` | "Can drive a browser session, including form submission and downloads" |
## Per-Step Disclosure (REQUIRED on step creation)
After defining or modifying a step, display its permission profile. For destructive/sensitive steps:
```
Permissions for step "deploy-code":
[DESTRUCTIVE] deploy-code (bash)
Permission level: elevated
Allowed tools: Edit, Write, Bash, Read, Glob, Grep
Warnings:
!! shell: Can execute arbitrary shell commands (rm, git push, etc.)
!! fs:write: Can create, overwrite, or delete files on disk
```
For safe steps, still display — with a reassuring tone:
```
Permissions for step "analyze-logs":
[SAFE] analyze-logs (bash)
Permission level: readonly
Allowed tools: Read, Glob, Grep
No destructive capabilities.
```
When editing an existing step, if the change introduces new destructive capabilities or raises the permission level, call this out explicitly.
## Spell-Wide Dry-Run Report (REQUIRED before first run)
After schema validation passes for a new or updated spell, display the full permission report and require user acceptance before the spell can be cast:
```
Permission Report: <spell-name>
Overall risk: [DESTRUCTIVE] destructive
Permission hash: a1b2c3d4e5f6g7h8
[SAFE] fetch-config (bash)
Permission level: readonly
Allowed tools: Read, Glob, Grep
[DESTRUCTIVE] implement-story (bash)
Permission level: elevated
Allowed tools: Edit, Write, Bash, Read, Glob, Grep
Warnings:
!! shell: Can execute arbitrary shell commands (rm, git push, etc.)
!! fs:write: Can create, overwrite, or delete files on disk
[SENSITIVE] analyze-results (agent)
Permission level: standard
Allowed tools: Edit, Write, Read, Glob, Grep
Warnings:
! agent: Can spawn autonomous Claude sub-agents
--- DESTRUCTIVE STEPS ---
1 step(s) can make destructive changes:
- implement-story: shell, fs:write
These steps can modify files, run shell commands, or access credentials.
Review the spell definition before accepting.
```
Then ask:
> The spell requires the permissions shown above. Do you accept? (y/n)
On acceptance the permission hash is stored. Subsequent runs do NOT re-prompt unless the spell's permissions change. Regular runs (not dry-runs) skip this verbose output and silently check the stored hash.
## See Also
- [SKILL.md](SKILL.md) — main spell-builder skill
- [preflight.md](preflight.md) — preflight check authoring
- [architecture.md](architecture.md) — three-layer model (spell → step → connector)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |