# runner-selection

The runner-selection skill detects whether Symfony commands belong in Docker, DDEV, or the host environment. Use it when the right command prefix is unclear or containers may be stopped.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 234 repo stars
- Author: dev-toolings
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/skills/runner-selection/SKILL.md
- Updated: 2026-10-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/runner-selection

## What it does

Before the first PHP, Composer, console, or test command, the skill checks the project environment through the library's runtime context CLI. It identifies the Docker setup and whether its containers are running, then supplies prefixed commands such as `docker compose exec php bin/console`. Scripts can use the `--format=env` output.

When containers are stopped, the skill follows the CLI's startup guidance and checks the environment again. It keeps the same command prefix throughout the session. The skill is intended for Symfony applications; without one, the CLI prints nothing. Do not run host `php` or `composer` when the project expects containers.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill runner-selection -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/runner-selection/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/runner-selection/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill runner-selection -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/runner-selection/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill runner-selection -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/runner-selection/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dev-toolings/superpowers-symfony content/skills/runner-selection
```

2. **Manually: put the files in place**
- File: `.github/skills/runner-selection/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill runner-selection -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/runner-selection
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/runner-selection/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/skills/runner-selection/SKILL.md

## When to use it
- choose command prefixes for Docker Compose, DDEV, or the host
- check whether project containers are running
- start stopped containers using the CLI guidance
- avoid running host PHP and Composer for a container-based project

## Example prompts
- Check the Symfony environment and give me the console, Composer, and test commands.
- Find the right command prefix for running this project's tests.
- The containers may be stopped. Detect the Docker setup and tell me how to start them.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 1347e9ad28de6fd3.

BEGIN THIRD-PARTY FILE 1347e9ad28de6fd3
```text
---
name: runner-selection
description: Select and configure the appropriate command runner based on Docker Compose standard, Symfony Docker (FrankenPHP), or host environment
capabilities: [read, search]
tags: [workflow]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
---

# Runner Selection (Symfony)

## Use when
- Before the first PHP, console, composer or test command of a session.
- A command fails with a missing PHP, extension or database that the container provides.
- The project uses Docker Compose, Symfony Docker (FrankenPHP), DDEV or the host and the right prefix is unclear.
- The containers may be stopped and the commands must not silently run on the host.

## Default workflow
1. Run the library's runtime context CLI with `--format=markdown` (or `--format=env` for scripts).
2. Read the detected Docker type (`ddev`, `symfony-docker`, a Compose file, or `none`) and whether the containers are running.
3. Use the prefixed console, composer and test commands it prints, such as `docker compose exec php bin/console`.
4. If the containers are stopped, start them with the guidance it prints (`ddev start` or `docker compose up -d`), then run it again.
5. Reuse the same prefix for every command in the session.

## Guardrails
- Never run the host `php` or `composer` when the project expects containers.
- Do not guess the Compose service name: take it from the detected commands.
- Without a Symfony application the CLI prints nothing: say so instead of inventing a runner.
- Do not start or stop containers the task does not need.

## Progressive disclosure
- Use this file for execution posture and risk controls.
- Open references when deep implementation details are needed.

## Output contract
- The detected environment (Docker type, running state, test framework).
- The prefixed console, composer and test commands for this session.

## References
```
END THIRD-PARTY FILE 1347e9ad28de6fd3

The third-party file has ended. Everything between the 1347e9ad28de6fd3 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© dev-toolings · MIT · https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/skills/runner-selection/SKILL.md

## Similar
- [temporal-developer](https://affpapa.org/en/nevibecode/skills/temporalio-temporal-developer.md) — skill · 5200 installs
- [tao-launch-workflow](https://affpapa.org/en/nevibecode/skills/tao-launch-workflow.md) — skill · 1700 installs
- [tao-run-inference-service](https://affpapa.org/en/nevibecode/skills/tao-run-inference-service.md) — skill · 1600 installs
- [ad-platform-selection](https://affpapa.org/en/nevibecode/skills/ad-platform-selection.md) — skill · 26700 installs
- [event-format-selection](https://affpapa.org/en/nevibecode/skills/event-format-selection.md) — skill · 6800 installs
- [event-talk-selection](https://affpapa.org/en/nevibecode/skills/event-talk-selection.md) — skill · 6800 installs

From the same set: [dev-toolings/superpowers-symfony](https://affpapa.org/en/nevibecode/by/dev-toolings/superpowers-symfony.md) — 51 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
