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

connectors/github-cli/README.md

View on GitHub
# `github-cli` — GitHub CLI Connector

**Purpose:** Use this connector as the backing connector for the `github` step command, or from a custom step command. Choose this when you need programmatic access to GitHub issues, PRs, and repos.

## Usage

From a spell, reach this connector through the `github` step, which delegates to it:

```yaml
- id: fetch-bug
  type: github
  config:
    action: issue-fetch
    issue: 42
    fields: ["number", "title", "labels", "state"]
```

> Earlier revisions of this file showed an `agent` step calling `context.tools.execute(...)` from a prompt. The `agent` step type has never been executable — use the `github` step, a composite step's `tool` action, or a custom step command.

## Actions

Taken from `VALID_ACTIONS` in `src/cli/spells/connectors/github-cli.ts`. `issue-create`, `issue-list`, `pr-list` and `repo-view` were listed here previously but have never existed.

| Action | Required params | Description |
|--------|-----------------|-------------|
| `issue-fetch` | `issue` | Fetch issue details as JSON (`fields` selects columns) |
| `issue-edit` | `issue` | Edit an existing issue |
| `pr-create` | `title` | Create a pull request |
| `pr-merge` | `pr` or `issue` | Merge a PR (`mergeMethod`: squash \| merge \| rebase) |
| `pr-find` | `head` or `search` | Find a PR by head branch or search query |
| `label` | (`issue` or `pr`) + `labels` | Add/remove labels |
| `comment` | (`issue` or `pr`) + `body` | Post a comment |
| `repo-info` | — | View repository metadata |

## Direct Usage

```javascript
const result = await context.tools.execute('github-cli', 'issue-create', {
  repo: 'my-org/backend-api',
  title: 'Fix: null pointer in auth middleware',
  body: 'The auth middleware crashes when the token header is missing.',
  labels: ['bug']
});
```

## Capabilities

`read`, `write`, `search`

## Prerequisites

Requires `gh` CLI installed and authenticated (`gh auth login`).

## Source

`src/cli/spells/connectors/github-cli.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: 321kUpdated 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: 197kUpdated 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: 197kUpdated 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: 197kUpdated Claude CodeCodexVerifiedInstall