effective-context — Claude Code skill: Symfony task context
effective-context is a Claude Code skill that teaches an agent to gather context for Symfony development: versions, error-path files, stack traces, and project constraints.
MIT ★ 234 updated 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill effective-context -a claude-codeWhat effective-context does
Skill defines a template for handing a Symfony task to the agent. Agent starts with the goal and expected behavior in two sentences, then gives versions of Symfony, PHP and involved bundles. Next come files on the problem path — entity, service, controller, config, not the whole src/. After that: full error with stack trace, relevant log lines, constraints (performance, backward compatibility, project patterns) and what was already tried.
Installation puts SKILL.md into the Claude Code directory (path depends on platform). Skill uses Read, Glob and Grep tools to read files and search the project. Without explicit versions and files, the agent gives an inaccurate answer.
Output is a context block following the template in reference.md: context, goal, current code, observed behavior, attempts, constraints. Secrets and personal data from logs and .env are stripped before sending.
What it helps with
- gather context for diagnosing a Symfony error
- hand a task to another developer with all versions and constraints
- fix an inaccurate agent answer by adding bundle versions
- show the agent the problem path without extra files
Example prompts for the agent
- Help me debug a Symfony controller error — need context using the
effective-contexttemplate - Gather context for the task: versions, files on the path, stack trace and what was tried
- Prepare a context block for handing over the task — use the
effective-contextskill template
How to install effective-context
1Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill effective-context -a claude-code2Manually: put the files in place
~/.claude/skills/effective-context/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/effective-context/
1Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill effective-context -a codex2Manually: put the files in place
.agents/skills/effective-context/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill effective-context -a cursor2Manually: put the files in place
.cursor/skills/effective-context/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/effective-context2Manually: put the files in place
.github/skills/effective-context/SKILL.md1Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill effective-context -a gemini-cli2Platform CLI
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/effective-contextManually: put the files in place
.devin/skills/effective-context/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 effective-context
How to install effective-context in Claude Code?
Run npx skills add dev-toolings/superpowers-symfony --skill effective-context -a claude-code. The skill appears in ~/.claude/skills/effective-context/SKILL.md.
What does the effective-context skill do?
Skill teaches the agent to gather context for a Symfony task: framework and bundle versions, files on the problem path, stack trace, logs and project constraints. Without it, the agent gives inaccurate answers.
Which tools does effective-context use?
Skill uses Read to read files, Glob to search by pattern and Grep to search text in the project. All three are standard Claude Code tools.
Source text
SKILL.md · MIT
--- name: effective-context description: Provide effective context to the coding agent for Symfony development with relevant files, patterns, and constraints capabilities: [read, search] tags: [workflow] # projected by `bun run build` — do not edit by hand allowed-tools: - Read - Glob - Grep --- # Effective Context (Symfony) ## Use when - Asking for help on a Symfony problem, or handing a task over to someone else. - A previous answer was wrong because versions, bundles or constraints were missing. - Reporting an error that needs diagnosis. ## Default workflow 1. State the goal and the expected behavior in one or two sentences. 2. Give the versions: Symfony, PHP, and the bundles involved. 3. Include only the files on the path of the problem: entity, service, controller, configuration. 4. Paste the full error with its stack trace, and the relevant log lines. 5. List the constraints (performance, backward compatibility, existing patterns) and what was already tried. ## Guardrails - Send the code on the path of the problem: not the whole `src/`, not a bare one-line question. - Do not refer to code that was not shown. - Strip secrets and personal data from logs and `.env` excerpts. ## Progressive disclosure - Use this file for execution posture and risk controls. - Open references when deep implementation details are needed. ## Output contract - A context block following the template in `reference.md`: context, goal, current code, observed behavior, attempts, constraints. - Versions and bundles, stated explicitly. ## References - `reference.md`
© dev-toolings · MIT · dev-toolings/superpowers-symfony