bootstrap-check — Claude Code skill: verify Symfony project setup
bootstrap-check runs a pass/fail check over a Symfony project's setup: .env, services, Doctrine mappings, routes. Each failure comes with the fix.
MIT ★ 234 updated 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill bootstrap-check -a claude-codeWhat bootstrap-check does
The skill walks a Symfony project from the ground up. Does .env exist and carry APP_SECRET with DATABASE_URL? Is vendor/ in place, does bin/console about answer, does the container compile through cache:clear? Then it looks at the database connection and compares the schema against the Doctrine mappings, and lists whatever optional pieces are wired in: API Platform resources, Messenger transports.
The allowed tools are Read, Glob and Grep, so nothing gets edited while the check runs. What you get back is a checklist with each item marked passed or failed, plus the exact command or file to change for every failure, and a note on what was left out of scope.
Order matters. Step two needs vendor/ and a working console, so a fresh clone wants composer install first. Doctrine checks belong on a development database. Secrets from .env stay out of the report, and for cache permission trouble the skill points at ACLs instead of chmod 777.
What it helps with
- find out why a freshly cloned app refuses to boot
- check
.envfor missing bundle variables - confirm the container compiles after
cache:clear - compare the database schema against Doctrine mappings
- see which Messenger transports and API Platform resources are wired in
Example prompts for the agent
- Check the bootstrap of this Symfony project:
.env,services.yaml, Doctrine — and show me what's broken - The container won't compile after
cache:clear, run the config check and give me exact fixes - List the API Platform resources and Messenger transports this app has
How to install bootstrap-check
1Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill bootstrap-check -a claude-code2Manually: put the files in place
~/.claude/skills/bootstrap-check/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bootstrap-check/
1Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill bootstrap-check -a codex2Manually: put the files in place
.agents/skills/bootstrap-check/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill bootstrap-check -a cursor2Manually: put the files in place
.cursor/skills/bootstrap-check/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/bootstrap-check2Manually: put the files in place
.github/skills/bootstrap-check/SKILL.md1Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill bootstrap-check -a gemini-cli2Platform CLI
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/bootstrap-checkManually: put the files in place
.devin/skills/bootstrap-check/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about bootstrap-check
How do I install bootstrap-check in Claude Code?
Run npx skills add dev-toolings/superpowers-symfony --skill bootstrap-check -a claude-code. The skill file lands at ~/.claude/skills/bootstrap-check/SKILL.md.
What does bootstrap-check do?
It inspects .env, the installed vendor/, container compilation, the database connection and the schema against Doctrine mappings. You get a checklist of failures with the commands or files that fix them.
Does the skill write to my project?
No. Only Read, Glob and Grep are available to it, so configuration gets read and reported, and the edits stay with you.
Source text
SKILL.md · MIT
--- name: bootstrap-check description: Verify Symfony project configuration including .env, services.yaml, doctrine settings, and framework requirements capabilities: [read, search] tags: [workflow, config] # projected by `bun run build` — do not edit by hand allowed-tools: - Read - Glob - Grep --- # Bootstrap Check (Symfony) ## Use when - Starting work on an unfamiliar or freshly cloned Symfony project. - The application fails to boot, the container does not compile, or routes are missing. - Checking `.env`, `config/packages/*`, Doctrine, API Platform or Messenger setup before a change. ## Default workflow 1. Confirm `.env` exists and defines `APP_SECRET`, `DATABASE_URL` and the variables the bundles need. 2. Confirm `vendor/` is installed and `bin/console about` runs. 3. Compile the container (`cache:clear`) and list services and routes. 4. Check the database connection and that the schema matches the mappings. 5. Check the optional stacks present: API Platform resources, Messenger transports. ## Guardrails - Read only: report what is missing, do not rewrite configuration while checking. - Never print secret values from `.env` or the vault. - Prefer ACLs or the correct user over `chmod 777` for cache permission issues. - Run Doctrine checks against a development database, never production. ## Progressive disclosure - Use this file for execution posture and risk controls. - Open references when deep implementation details are needed. ## Output contract - The checklist with each item passed or failed. - The exact fix for each failure (command or file to change). - What was not checked, and why. ## References - `reference.md`
© dev-toolings · MIT · dev-toolings/superpowers-symfony