Skip to main content
skill CX Codex

runner-selection — Claude Code skill for Symfony command runners

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.

MIT ★ 234 updated 2026-10-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dev-toolings/superpowers-symfony --skill runner-selection -a claude-code
Open on GitHub

What runner-selection 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.

What it helps with

  • 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 for the agent

  • 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.

How to install runner-selection

1Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill runner-selection -a claude-code

2Manually: put the files in place

~/.claude/skills/runner-selection/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/runner-selection/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about runner-selection

How do I install runner-selection in Claude Code?

Run npx skills add dev-toolings/superpowers-symfony --skill runner-selection -a claude-code. The skill file is at ~/.claude/skills/runner-selection/SKILL.md.

What does runner-selection do?

It detects the Symfony project's execution environment and provides prefixes for console, Composer, and test commands. It also gives guidance for starting stopped containers.

Can I use host commands when the project expects containers?

No. The skill instructs Claude Code not to run host php or composer when the project expects containers.

Source text

SKILL.md · MIT
---
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

© dev-toolings · MIT · dev-toolings/superpowers-symfony

Similar skills

SKILL.md skills catalog →
temporal-developer temporalio temporal-developer — a Claude Code skill that guides building workflows, activities, and workers across eight Temporal SDKs. It activates when debugging non-determinism, handling retries, or testing workflows via CLI. CX Codex +1 5,200installs tao-launch-workflow NVIDIA Corporation tao-launch-workflow — a skill for Claude Code, Codex, Cursor and more: a mandatory preflight gate before any TAO workflow fires. Triggers before training, AutoML, inference, export, and TensorRT engine generation. CX Codex +1 1,700installs tao-run-inference-service NVIDIA Corporation tao-run-inference-service deploys network-specific NVIDIA TAO inference microservices in containers and halts them. Use it to run checkpoints and query endpoints without cloud storage. CX Codex +1 1,600installs ad-platform-selection Maya-Beth Finotti ad-platform-selection selects paid media channel families based on unit economics, audience, and budget before launch. Eliminates options using allowable CAC and payback thresholds. CX Codex +1 26,700installs event-format-selection Samuel Berthe event-format-selection helps organizers select technical event formats before scheduling: determines event shape, track count, talk-to-workshop balance, and in-person or hybrid delivery. CX Codex +1 6,800installs event-talk-selection Samuel Berthe event-talk-selection runs CFP review pipelines for tech events. It sets up scoring rubrics, blinded reviews, conflict handling, and program balance across submission shortlists. CX Codex +1 6,800installs

From the same set51

The whole set →
doctrine-transactions doctrine-transactions guides Claude Code on managing Doctrine ORM 3 transactions, locking strategies, and flush boundaries in Symfony applications. Fits concurrent row edits and rollback recovery. CX Codex +1 ★ 234repo stars doctrine-batch-processing doctrine-batch-processing is a Claude Code skill for processing large Doctrine datasets in memory-conscious imports, exports, and backfills. CX Codex +1 ★ 234repo stars controller-cleanup The controller-cleanup skill extracts business logic from fat Symfony controllers into services, handlers and commands. Leaves actions lean, delegating and responding only. CX Codex +1 ★ 234repo stars brainstorming brainstorming structures feature discovery for Symfony projects: clarifies unclear requirements, identifies framework components, and compares architecture designs. CX Codex +1 ★ 234repo stars doctrine-events doctrine-events — a Claude skill for attaching side effects to Doctrine entity events in Symfony: timestamps, slugs, search index updates, notifications. CX Codex +1 ★ 234repo stars form-types-validation form-types-validation generates Symfony form types, configures DTO validation groups, handles HTTP 422 responses, and sets up multi-step flows. CX Codex +1 ★ 234repo stars tdd-with-phpunit The tdd-with-phpunit skill guides PHPUnit-driven work on Symfony features, from checking a failing test to refactoring after it passes. Use it for command, form, and external-service tests. CX Codex +1 ★ 234repo stars using-symfony-superpowers using-symfony-superpowers is a Claude Code skill that detects the Symfony version, selects a skill, and sequences steps for complex tasks. CX Codex +1 ★ 234repo stars

Project sponsors

Companies that keep this analytics open