Kocal/symfony-contribution-skills
6 stars · Last commit 2026-07-21
IA skills for contributing to the Symfony framework & related packages
README preview
# Symfony Contributions Skills **Contribute to Symfony like a regular, with your AI agent already knowing the house rules.** 🤖 A small plugin that teaches [Claude Code](https://docs.claude.com/en/docs/claude-code/overview), [OpenAI Codex](https://developers.openai.com/codex), and [Gemini CLI](https://github.com/google-gemini/gemini-cli) the official Symfony contribution rules, so your pull requests land clean on the first try instead of bouncing through three rounds of review. The rules are distilled from Symfony's own [contribution docs](https://symfony.com/doc/current/contributing/index.html) and stay traceable to the exact `.rst` sources they came from. [](LICENSE) · Works with **Claude Code** · **OpenAI Codex** · **Gemini CLI** ## ✨ Why Open a PR on [`symfony/symfony`](https://github.com/symfony/symfony) or [`symfony/symfony-docs`](https://github.com/symfony/symfony-docs) and a reviewer will (kindly) point out that your comparison should be Yoda-style, your deprecation is missing its `UPGRADE-*.md` note, or your `.rst` used single backticks instead of double. These skills front-load all of it, so your agent gets it right while writing the code, not after someone flags it. ## 🧩 Skills | Skill | Reach for it when | Distilled from | |---|---|---| | [**symfony-code-contribution**](skills/symfony-code-contribution/SKILL.md) | You're writing or reviewing **PHP** for Symfony core, a bundle, UX (PHP side), AI, etc. Coding standards, naming, deprecations, the backward-compatibility promise, and the patch-version policy. | [standards](https://symfony.com/doc/current/contributing/code/standards.html) · [conventions](https://symfony.com/doc/current/contributing/code/conventions.html) · [bc](https://symfony.com/doc/current/contributing/code/bc.html) · [maintenance](https://symfony.com/doc/current/contributing/code/maintenance.html) | | [**symfony-docs-contribution**](skills/symfony-docs-contribution/SKILL.md) | You're writing or editing **`.rst`** docs for symfony-docs or a package. reStructuredText format, the writing standards, and the doc PR workflow. | [format](https://symfony.com/doc/current/contributing/documentation/format.html) · [standards](https://symfony.com/doc/current/contributing/documentation/standards.html) | > 💡 Working on a JS/TS project like [Webpack Encore](https://github.com/symfony/webpack-encore)? These skills don't apply: follow that project's own `CONTRIBUTING`.