Skip to content
Back to search

pimcore-toolkit

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/muhammed-rishank--pimcore-toolkit/badge.svg)](/listings/muhammed-rishank--pimcore-toolkit)

HTML

<a href="/listings/muhammed-rishank--pimcore-toolkit"><img src="/api/listings/muhammed-rishank--pimcore-toolkit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

In Claude Code:

/plugin marketplace add muhammed-rishanK/pimcore-toolkit
/plugin install pimcore-toolkit@pimcore-toolkit

Or from a terminal:

claude plugin marketplace add muhammed-rishanK/pimcore-toolkit
claude plugin install pimcore-toolkit@pimcore-toolkit

To try a local copy for one session: `claude --plugin-dir /path/to/pimcore-toolkit`.

Update to the latest version:

claude plugin marketplace update pimcore-toolkit
claude plugin update pimcore-toolkit@pimcore-toolkit

Then run `/reload-plugins`. See `CHANGELOG.md` for what changed.

Type `/pimcore` or `/pimcore-setup` to check that the commands are available.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "pimcore-toolkit",
  3. "owner": {
  4. "name": "muhammed-rishanK",
  5. "url": "https://github.com/muhammed-rishanK"
  6. },
  7. "metadata": {
  8. "description": "Pimcore Engineering Toolkit for Claude Code: development workflows and environment setup for Pimcore 10, 11, 12, the 2025.4 LTS and 2026 with Pimcore Studio."
  9. },
  10. "plugins": [
  11. {
  12. "name": "pimcore-toolkit",
  13. "source": "./",
  14. "description": "Pimcore development (/pimcore) and environment setup (/pimcore-setup) with specialist agents, including Studio and 2026 upgrade support."
  15. }
  16. ]
  17. }
README.md · README · 216 lines
  1. # Pimcore Engineering Toolkit
  2. A Claude Code plugin for Pimcore projects. It is version-aware and has no ties to any one project. It gives you two commands:
  3. - **`/pimcore <request>`**: the development entry point. It takes a request in plain language, detects the project's Pimcore, PHP and Symfony versions, reads the project's `CLAUDE.md`, starts only the specialist agents the task needs, validates the work and reports.
  4. - **`/pimcore-setup [name] [flags]`**: sets up a Pimcore development environment on Linux, macOS, WSL2 or Windows. Docker is the default and native is optional. Credentials are generated and never printed, and it finishes with five health checks.
  5. ## Install
  6. In Claude Code:
  7. ```text
  8. /plugin marketplace add muhammed-rishanK/pimcore-toolkit
  9. /plugin install pimcore-toolkit@pimcore-toolkit
  10. ```
  11. Or from a terminal:
  12. ```bash
  13. claude plugin marketplace add muhammed-rishanK/pimcore-toolkit
  14. claude plugin install pimcore-toolkit@pimcore-toolkit
  15. ```
  16. To try a local copy for one session: `claude --plugin-dir /path/to/pimcore-toolkit`.
  17. Update to the latest version:
  18. ```bash
  19. claude plugin marketplace update pimcore-toolkit
  20. claude plugin update pimcore-toolkit@pimcore-toolkit
  21. ```
  22. Then run `/reload-plugins`. See `CHANGELOG.md` for what changed.
  23. Type `/pimcore` or `/pimcore-setup` to check that the commands are available.
  24. ## Quick start
  25. Your first command depends on where you start.
  26. **You have no Pimcore project yet.** Open an empty folder in Claude Code and run:
  27. ```text
  28. /pimcore-setup my-shop
  29. ```
  30. It detects your OS and installed tools, shows a plan and asks before anything risky. It then creates the project, generates secrets (never printed), starts the services, installs Pimcore and runs five health checks. The final report lists the URLs, the admin username and the command that reads the password.
  31. **You already have a Pimcore project.** Run this inside the project. It changes nothing and reports what is healthy and what is broken:
  32. ```text
  33. /pimcore-setup --check
  34. ```
  35. If something is broken, `/pimcore-setup --repair` diagnoses it and applies each fix only after you approve it.
  36. **Once the environment is healthy**, develop with `/pimcore`:
  37. ```text
  38. /pimcore explain how Product objects get their prices
  39. ```
  40. For Pimcore 12 use `--version 2025.4` (the skeleton has no `12` tag; 2025.4 installs `pimcore/pimcore ^12.3` with the Classic UI, and `--version 2026` installs Studio only).
  41. Run `/pimcore-setup --plan` to see which versions can be installed (with PHP needs and whether a product key is required) and what happens in each situation, without building anything. A normal run prints the same table, installs the recommended row and records the choice.
  42. Useful `/pimcore-setup` options: `--plan`, `--ask`, `--secure-admin`, `--no-install`, `--runtime docker|native`, `--profile skeleton|demo`, `--version 11` or `--version 2025.4`, `--dir <path>`, `--check`, `--repair`.
  43. ## Usage examples
  44. ```text
  45. /pimcore explain how Product objects get their prices
  46. /pimcore JIRA-12: add a read-only lastSyncedAt date on the Product edit page
  47. /pimcore design a Supplier class with contacts, addresses and a relation to Product
  48. /pimcore saving a Product fails with "Integrity constraint violation"
  49. /pimcore integrate the ERP price REST API into Product objects
  50. /pimcore review my current changes
  51. /pimcore write PHPUnit tests for ProductPriceCalculator
  52. /pimcore plan an upgrade from Pimcore 10.6 to 11
  53. /pimcore --route <request> # show the routing decision only, change nothing
  54. /pimcore-setup acme-pim # Docker, skeleton profile, newest stable
  55. /pimcore-setup acme-demo --profile demo
  56. /pimcore-setup acme-pim --runtime native --version 11
  57. /pimcore-setup --dir ./existing-project # existing profile is picked automatically
  58. /pimcore-setup --check --dir ./acme-pim # health checks only
  59. /pimcore-setup --repair --dir ./acme-pim # diagnose and fix a broken environment
  60. ```
  61. ## Agents
  62. | Agent | Model | Writes code | Role |
  63. |---|---|---|---|
  64. | `pimcore-solution-architect` | opus | no | design, impact, phases, test plan |
  65. | `pimcore-developer` | sonnet | yes | implementation and tier 1 checks |
  66. | `pimcore-data-modeler` | opus | no | classes, field collections, bricks, classification store, data migration plans |
  67. | `pimcore-debugger` | opus | no | reproduce, root cause, smallest safe fix |
  68. | `pimcore-integration-specialist` | opus | no | ERP, eCommerce, REST, queues, DataHub, import and export design |
  69. | `pimcore-code-reviewer` | opus | no | independent review of the real diff against the request |
  70. | `pimcore-qa-engineer` | sonnet | tests only | PHPUnit and Codeception tests, acceptance and regression checks |
  71. | `pimcore-upgrade-specialist` | opus | no | version analysis, breaking changes, upgrade plan |
  72. | `pimcore-environment-setup` | sonnet | yes (new environment only) | runs the build steps of `/pimcore-setup` |
  73. ## Supported Pimcore lines
  74. | Line | Admin UI | Notes (from the official docs, see `references/pimcore-versions.md`) |
  75. |---|---|---|
  76. | 10.x | classic, inside core | Symfony 5.4 |
  77. | 11.x | classic, separate bundle | Symfony 6.2+, many features moved to bundles |
  78. | 12.x | classic, Studio can run beside it | last numbered line; installed with skeleton `2025.x` (2025.4 requires `pimcore/pimcore ^12.3`) |
  79. | 2025.4 (LTS) | classic, Studio compatible | three years from the 2025-12-09 release, platform only; last release with the classic UI |
  80. | 2026.x | Studio only | PHP 8.4 or 8.5, Symfony 7.x, `pimcore-install --install-profile` |
  81. `detect-project.sh` reports `releaseLine`, `yearBased` and `adminUi` (core, both, studio, classic or unknown), so agents pick the right modules without guessing. For a move to 2025.4 or 2026 the `platform-2026-upgrade` module gives a phased plan with targeted migration commands and a rollback.
  82. ## Upgrade impact scan
  83. For an upgrade plan (for example 2024 to 2026) the upgrade specialist starts from a repeatable, read-only scan instead of ad-hoc grepping:
  84. ```bash
  85. bash skills/pimcore/scripts/scan-platform-impact.sh <project-root> --to 2026 # table
  86. bash skills/pimcore/scripts/scan-platform-impact.sh <project-root> --to 12 --format json
  87. ```
  88. `--to` picks how far the plan goes: `2024` (deprecations in 11.5 and 2024.x), `2025` or `12` (Pimcore 12 and 2025.x, `12` is an alias), `2026` (2026.x, default). Steps are cumulative, so `--to 2026` also runs the earlier rules.
  89. For each documented breaking-change item the scan lists every matching `file:line`, says whether the rule is `documented` or `heuristic`, links the official page and names the rules that did not match. There are 59 rules: 7 for the 2024 step, 35 for the 2025 step and 17 for the 2026 step. It skips `vendor/`, `var/`, `node_modules/` and `.git/`, and it changes nothing. The rules are data in `skills/pimcore/scripts/platform-impact-rules.json`, so a new breaking change is a new entry.
  90. It does not replace a PHP deprecation report. Add PHPStan deprecation rules or the Symfony deprecation log for deprecated calls the rules do not list.
  91. ## Skills and modules
  92. Claude Code discovers skills only one level deep (`skills/<name>/SKILL.md`). The 26 skills are therefore module files inside two hidden skills, and each loads only when needed. All modules share one template: Purpose and scope (use when / do not use when), Inspect, Workflow, Best practices, Common mistakes, Version notes, Example, Validation checklist, Expected output.
  93. **`pimcore-engineering`** (18 development modules): requirements-analysis, solution-planning, pimcore-architecture, backend-development, data-modelling, admin-ui-development, studio-ui-development, studio-backend-extension, object-lifecycle, integration-development, data-import-export, performance-optimization, security-best-practices, testing-validation, code-review, upgrade-migration, platform-2026-upgrade, deployment-release.
  94. **`pimcore-environment`** (8 setup modules): environment-detection, docker-environment, native-environment, pimcore-installation, database-provisioning, environment-security, setup-validation, environment-troubleshooting.
  95. ### Agent to module mapping
  96. | Agent | Preloaded skill | Main modules |
  97. |---|---|---|
  98. | solution-architect | pimcore-engineering | solution-planning, pimcore-architecture, requirements-analysis, studio modules and platform-2026-upgrade when relevant |
  99. | developer | pimcore-engineering | backend-development, admin-ui-development, studio-ui-development, studio-backend-extension, object-lifecycle, security-best-practices |
  100. | data-modeler | pimcore-engineering | data-modelling, object-lifecycle, data-import-export |
  101. | debugger | pimcore-engineering | object-lifecycle, performance-optimization, pimcore-architecture |
  102. | integration-specialist | pimcore-engineering | integration-development, data-import-export, security-best-practices |
  103. | code-reviewer | pimcore-engineering | code-review, security-best-practices, performance-optimization |
  104. | qa-engineer | pimcore-engineering | testing-validation |
  105. | upgrade-specialist | pimcore-engineering | upgrade-migration, platform-2026-upgrade, deployment-release |
  106. | environment-setup | pimcore-environment | all 8 setup modules |
  107. ## How orchestration works
  108. 1. `/pimcore` runs `detect-project.sh`. The script is read-only and reports the Pimcore, PHP and Symfony versions from `composer.lock`, plus Docker, the test tools and the project instruction files. The command then reads the project's `CLAUDE.md`, whose rules override the toolkit's.
  109. 2. It classifies the request with the routing table in `references/orchestration.md`. Questions are answered directly. Other requests get a workflow: A feature, B bug or performance, C data model, D integration, E review (E' tests only), F upgrade, G release.
  110. 3. The command coordinates the agents itself, because subagents cannot start other agents. It starts only the agents the task needs, in order, and passes each one the request, the version JSON, the module path and what earlier agents found.
  111. 4. Before any code changes, a checkpoint asks you first about class changes on existing data, destructive steps, new dependencies or open business questions. In other cases it shows a short plan and continues.
  112. 5. An independent reviewer checks code written in the run against the real `git diff`. Critical and high findings get at most two fix rounds.
  113. 6. Validation runs: tier 1 checks, tests, and container or route checks for configuration changes. The report lists every command and its result. Nothing is committed or pushed.
  114. `/pimcore-setup` works the same way. It runs `detect-env` and plans, and decides on its own. It installs missing prerequisites itself (WSL2 with Docker Engine inside it on Windows, Docker Engine on Linux with passwordless sudo, and Colima on macOS; all free, Docker Desktop is never installed). The only things it cannot do for you are the operating system's own consent steps: the Windows administrator prompt (only when WSL must be enabled), a `sudo` password and a restart. Use `--no-install` to skip installing. The `pimcore-environment-setup` agent builds the environment. The command then runs `health-check` itself and reports.
  115. ### Setup security
  116. - By default `/pimcore-setup` builds a local developer setup: the admin login is `admin` / `admin`, the database passwords are random, and every published port is bound to `127.0.0.1` so nothing is reachable from the network. Use `--secure-admin` for a random admin name and password, and never use the dev login on a server or shared host. Otherwise `gen-secrets` creates random credentials with a random admin suffix. They are written to `.pimcore-setup/secrets.env` with mode 600, and the compose credentials go to `docker-compose.override.yaml` with mode 600. Both files are git-ignored, and existing files are never overwritten.
  117. - The installer reads the secrets from stdin, so they never appear in command lines, logs or the report. You read the admin login yourself with `grep ADMIN .pimcore-setup/secrets.env`.
  118. - The five health checks: installation completed, database initialised (tables and an admin user), application healthy, admin login reachable, optional services (workers, Redis, search).
  119. ## Directory tree
  120. ```text
  121. pimcore-toolkit/
  122. .claude-plugin/plugin.json, marketplace.json
  123. agents/ 9 agents
  124. references/orchestration.md routing table, workflows, validation rules
  125. references/output-formats.md report formats (routing, feature, bug, review, plan, setup)
  126. references/pimcore-versions.md version matrix 10 to 2026, LTS, Studio, sources
  127. skills/pimcore/ /pimcore entry + scripts/{detect-project,scan-platform-impact}.sh + platform-impact-rules.json
  128. skills/pimcore-setup/ /pimcore-setup entry + scripts/{detect-env,gen-secrets,health-check}.{sh,ps1}
  129. skills/pimcore-engineering/ hidden, 18 modules
  130. skills/pimcore-environment/ hidden, 8 modules
  131. tests/test_structure.py structure and style checks (python3, no dependencies)
  132. tests/scenarios.md 8 routing scenarios
  133. ```
  134. ## Tests
  135. ```bash
  136. python3 tests/test_structure.py # frontmatter, mapping, modules, scripts, style
  137. claude plugin validate /path/to/pimcore-toolkit # manifest
  138. ```
  139. For the routing scenarios, see `tests/scenarios.md`.
  140. ## Limitations
  141. - The 26 skills are modules inside two hidden skills, not 26 separate skills. Claude Code does not discover nested skills.
  142. - The PowerShell scripts (`*.ps1`) have not been run on Windows yet. The bash scripts have been tested on Linux.
  143. - Version coverage: Pimcore 10, 11, 12.x, the 2025.4 LTS and the 2026 releases, taken from the official docs and listed with sources in `references/pimcore-versions.md`. Anything the docs do not state (licence and product key changes) is written as "not stated", and the toolkit tells you to read `composer.lock` and the official page.
  144. - Studio support: the Studio UI and Studio Backend modules cover what the official docs describe (React, Rsbuild, entry-point provider, backend controllers, events, grid tags). The JavaScript plugin registration API was not in the pages the modules are based on, so the module tells you to copy the official example bundle and read the installed package.
  145. - The upgrade impact scan only checks the items in its rules file, and `heuristic` matches (for example bundles matched by namespace because their Packagist name could not be confirmed) are leads, not proof. The 2024.x, 2025.x and 11 to 12 items were read from fetched summaries of the official upgrade notes, so check identifiers against `vendor/` or the linked page. The per-bundle upgrade notes (Data Importer, Data Hub, Generic Data Index and others) were not read.
  146. - The quality of the agents depends on the project. A project with no tests or static analysis gets weaker validation, and the report says so.
  147. - Future work: **`/pimcore-doctor`**, a read-only health and best-practice audit of an existing project. It would cover configuration, class definitions, workers, caches, indexes, security headers and deprecated API use, and would reuse `health-check` and the code-review module.
  148. ## Feedback and issues
  149. - **Bug or problem:** open an issue at https://github.com/muhammed-rishanK/pimcore-toolkit/issues. Include the plugin version (see `CHANGELOG.md`), your OS, the Pimcore and PHP versions, the command you ran and what happened. Remove passwords, tokens and private project names first.
  150. - **Idea or question:** open an issue and say it is a suggestion or a question.
  151. - **Liked it?** A star on the repository helps others find it.
  152. The plugin sends no usage data. This repository is the only place to reach the author.
  153. ## License
  154. MIT, see `LICENSE`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.