Agent skill

Runner Selection

by dev-toolings in dev-toolings/superpowers-symfony

Select and configure the appropriate command runner based on Docker Compose standard, Symfony Docker (FrankenPHP), or host environment

MITAuto-check passedDevOps & Cloud

Install Runner Selection

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dev-toolings/superpowers-symfony runner-selection --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dev-toolings/superpowers-symfony.git skills-src && mkdir -p .claude/skills && cp -r skills-src/content/skills/runner-selection .claude/skills/runner-selection && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
runner-selection
GitHub stars
222
Token cost
~481 tokens
SKILL.md length
244 words
Files
1
Skills in repo
44
Repo updated
First seen
Licence
MIT

At a glance

Select and configure the appropriate command runner based on Docker Compose standard, Symfony Docker (FrankenPHP), or host environment

  • Works in 5 steps: Run the library's runtime context CLI… → Read the detected Docker type (ddev,… → Use the prefixed console, composer and… → …
  • Tasks that involve Containers
  • SKILL.md covers Use when, Default workflow, Guardrails and Progressive disclosure, plus 2 more sections
  • Calls docker

What it does

Runner Selection is an agent skill from dev-toolings/superpowers-symfony. Select and configure the appropriate command runner based on Docker Compose standard, Symfony Docker (FrankenPHP), or host environment

Its SKILL.md is about 480 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Containers. It works with Docker, Symfony and PHP. The repository describes itself as: Claude Code plugin for Symfony 7.4 LTS & 8.x — 44 skills, 7 AI subagents & 13 commands for API Platform v4, Doctrine ORM 3, TDD (Pest/PHPUnit), Messenger, security & DDD. The licence is MIT.

When your agent uses it

  • Tasks that involve Containers

Example prompts

  • “/runner-selection”

Requirements

  • Docker
  • Pre-approved tools (allowed-tools): Read, Glob, Grep

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  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.

What it can do on your machine

Read from SKILL.md and the folder at commit 459bcd0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • docker

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use docker, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Runner Selection loads about 481 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 244 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~481

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dev-toolings/superpowers-symfony at commit 459bcd0, republished under its MIT licence (© dev-toolings). 244 words, ~481 tokens.

Download SKILL.mdSave it as .claude/skills/runner-selection/SKILL.md (or your agent's skills folder).
name
runner-selection
description
Select and configure the appropriate command runner based on Docker Compose standard, Symfony Docker (FrankenPHP), or host environment
allowed-tools
Read, Glob, Grep
capabilities
read, search
tags
workflow

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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in content/skills/runner-selection of dev-toolings/superpowers-symfony.

Open the folder on GitHubat commit 459bcd0

Compare with similar skills

Runner Selection next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Runner Selection compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Runner Selection this skilldev-toolings/superpowers-symfony222—~481Automated safety check: PassMIT
Shopware CLI Dockershopware/shopware-cli123—~1.8kAutomated safety check: PassMIT
Ddevhaxtheweb/haxcms-php130—~1.6kAutomated safety check: PassApache-2.0
Basercms Unittestbaserproject/basercms190—~4.9kAutomated safety check: PassMIT
Shopsys Commandsshopsys/shopsys350—~1.3kAutomated safety check: NotesCustom licence
GreptimeDB Dev Docker ImageGreptimeTeam/greptimedb6.7k—~4kAutomated safety check: NotesApache-2.0

Similar skills

  • Shopware CLI Docker

    shopware/shopware-cli

    A skill your agent uses when working on Docker-backed Shopware projects and needing to run Shopware or Symfony CLI commands, interact with project services or databases, start or stop the…

    123 GitHub stars~1.8k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Ddev

    haxtheweb/haxcms-php

    DDEV local development environment guidance for Docker-based PHP/Node projects.

    130 GitHub stars~1.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Basercms Unittest

    baserproject/basercms

    baserCMS(CakePHP5 / PHPUnit)のユニットテストをローカル Docker 環境で実行・調査する手順。「ユニットテストを実行して」「全テストを走らせて」「このテストだけ流して」「テスト失敗を調べて」「プラグイン単体でテストを動かしたい」「プラグインにテスト環境を導入したい」等のときに参照する。コンテナ名・実行コマンド・権限自動承認のためのコマンド整形・失敗の集計と切り分け方…

    190 GitHub stars~4.9k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Shopsys Commands

    shopsys/shopsys

    The command catalog for this Shopsys project — how to build, run, test, check code, access the database, and sync the GraphQL schema, including the macOS Mutagen workflow.

    350 GitHub stars~1.3k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • GreptimeDB Dev Docker Image

    GreptimeTeam/greptimedb

    Packages a locally built GreptimeDB debug binary into a development-only Docker image for local-cluster testing, with an optional push to a dev registry.

    6.7k GitHub stars~4k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes
  • Code Audit

    3stoneBrother/code-audit

    Professional code security audit skill covering 55+ vulnerability types.

    893 GitHub starsUsed in 1 repo~2.7k tokens
    SecurityAuto-check passed

More from dev-toolings/superpowers-symfony

All 44 skills in this repo
  • Symfony Scheduler

    dev-toolings/superpowers-symfony

    Schedule recurring tasks with the Symfony Scheduler component (native since 7.x); define schedules, triggers, and integrate with Messenger

    222 GitHub stars~526 tokensUpdated 2 days ago
    Auto-check: notes
  • API Platform Dto Resources

    dev-toolings/superpowers-symfony

    Map entities to API DTOs in API Platform (v5, 4.4, 4.3) with the Symfony Object Mapper ([Map], stateOptions) for decoupled input/output contracts

    222 GitHub stars~593 tokensUpdated 2 days ago
    Auto-check: notes
  • API Platform Filters

    dev-toolings/superpowers-symfony

    Implement API Platform filters - Parameters API (QueryParameter, v5/4.4/4.3) and the [ApiFilter] attribute deprecated since 4.4 - for search, date, range, boolean, and custom filtering

    222 GitHub stars~610 tokensUpdated 2 days ago
    Auto-check: notes
  • API Platform Resources

    dev-toolings/superpowers-symfony

    Configure API Platform resources (v5, 4.4, 4.3) with explicit operations, pagination, and typed OpenAPI for clean, versioned REST/GraphQL APIs

    222 GitHub stars~560 tokensUpdated 2 days ago
    Auto-check: notes
  • API Platform Security

    dev-toolings/superpowers-symfony

    Secure API Platform resources with security expressions, voters, securityPostValidation, and operation-level access control

    222 GitHub stars~551 tokensUpdated 2 days ago
    Auto-check: notes
  • API Platform Serialization

    dev-toolings/superpowers-symfony

    Control API Platform serialization with groups, [Context], IRI links (readableLink/writableLink), and custom context builders

    222 GitHub stars~519 tokensUpdated 2 days ago
    Auto-check: notes

Categories

Questions about Runner Selection

What does Runner Selection do?

Select and configure the appropriate command runner based on Docker Compose standard, Symfony Docker (FrankenPHP), or host environment. Runner Selection is an agent skill from dev-toolings/superpowers-symfony.

When should I use Runner Selection?

Runner Selection fits situations like: tasks that involve Containers.

How do I install Runner Selection in Claude Code?

Run `npx skills add dev-toolings/superpowers-symfony --skill runner-selection -a claude-code`. Or copy the skill folder (content/skills/runner-selection in dev-toolings/superpowers-symfony) into .claude/skills/runner-selection in your project. Claude Code loads it when a task matches its description.

How do I install Runner Selection in Codex?

Run `npx skills add dev-toolings/superpowers-symfony --skill runner-selection -a codex`. Or copy the skill folder (content/skills/runner-selection in dev-toolings/superpowers-symfony) into .agents/skills/runner-selection in your project. Codex loads it when a task matches its description.

Can I use Runner Selection in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dev-toolings/superpowers-symfony --skill runner-selection -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/runner-selection, .gemini/skills/runner-selection, .github/skills/runner-selection and .opencode/skills/runner-selection in your project.

What does Runner Selection need to run?

Going by SKILL.md and its folder, Runner Selection needs the command-line tools its instructions call (docker). Our summary lists: Docker. Its frontmatter pre-approves these tools: Read, Glob, Grep.

Does Runner Selection access the network?

SKILL.md contains no URLs. Its commands use docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Runner Selection safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Runner Selection use?

Runner Selection is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Runner Selection use?

About 481 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Runner Selection?

Skills that share tags, products or a category with Runner Selection: Shopware CLI Docker (shopware/shopware-cli, 123 stars), Ddev (haxtheweb/haxcms-php, 130 stars), Basercms Unittest (baserproject/basercms, 190 stars) and Shopsys Commands (shopsys/shopsys, 350 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Runner Selection?

dev-toolings (a GitHub organization) maintains it in dev-toolings/superpowers-symfony, which has 222 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 5, 2026.

Source: dev-toolings/superpowers-symfony on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.