mcpField
T
typo3-core-contributions

typo3-core-contributions

github.com/netresearchDevelopment138 installsUpdated 2d ago
Repository

About typo3-core-contributions

A skill for TYPO3 core contributors that guides issue analysis, code changes, testing, Gerrit review, and CI work. It distinguishes the core Gerrit workflow from the separate t3o sites GitLab process.

Key features

  1. 01TYPO3 contribution workflow guidance
  2. 02Gerrit patch submission and review
  3. 03Commit format and Change-Id guidance
  4. 04CI log and test troubleshooting
  5. 05Separate t3o GitLab workflow

Use cases

  1. 01Preparing a TYPO3 core patch
  2. 02Rebasing and updating a Gerrit review
  3. 03Diagnosing failing TYPO3 CI jobs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/netresearch/typo3-core-contributions-skill --skill typo3-core-contributions

After installing, type/typo3-core-contributionsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
account-setup.md
commit-message-format.md
commit-msg-hook.md
ddev-setup-workflow.md
forge-api.md
gerrit-review-patterns.md
gerrit-workflow.md
modern-typo3-patterns.md
proving-a-test.md
t3o-gitlab-workflow.md
troubleshooting.md
scripts/
create-commit-message.py
create-forge-issue.sh
query-forge-metadata.sh
setup-typo3-coredev.sh
t3o-gitlab.py
validate-commit-message.py
verify-prerequisites.sh

Details

From the project README

TYPO3 Core Contributions

When to Use — route by host

review.typo3.org (Gerrit), forge.typo3.org (Redmine), git.typo3.org/typo3/CI/cms (CI logs) are Core: Forge issues, patches, review, commit format, cherry-picks, rebasing — everything below. git.typo3.org/services/t3o-sites/** is plain GitLab for the t3o sites: no Gerrit, refs/for/main means nothing. Read references/t3o-gitlab-workflow.md first.

Prerequisites

Run ${CLAUDE_SKILL_DIR}/scripts/verify-prerequisites.sh: TYPO3.org account, Gerrit SSH (ssh -p 29418 <user>@review.typo3.org), Git email matching Gerrit.

Workflow

  1. Setup: ${CLAUDE_SKILL_DIR}/scripts/setup-typo3-coredev.sh
  2. Branch: git checkout -b feature/<issue>-description
  3. Analyze: root cause, reproduction, affected versions first
  4. Develop: fix + tests, validate with typo3-conformance-skill. Prove each test fails without the fix — references/proving-a-test.md
  5. Commit: format below, Resolves: #<issue> + Releases:
  6. Push: git push origin HEAD:refs/for/main%wip — a plain push is not WIP; reviewers vote and amending outdates their votes
  7. CI: wait for all jobs, read the actual logs at git.typo3.org/typo3/CI/cms/-/jobs/<id>, fix ALL failures in one amend+push
  8. Ready: git push origin HEAD:refs/for/main%ready or Gerrit UI "Start Review"
  9. Review: amend, preserve Change-Id. Fetch the reviewer's patchset first: git fetch origin refs/changes/XX/NNNNN/N && git reset --soft FETCH_HEAD
  10. Update: git commit --amend && git push origin HEAD:refs/for/main

Commit Format

[TYPE] Subject (imperative mood, max 52 chars)

How and why (not what). Wrap at 72 chars.

Resolves: #12345
Releases: main, 13.4, 12.4

[BUGFIX] [FEATURE] (main only) [TASK] [DOCS] [SECURITY]; breaking: [!!!], Releases: main only. Every commit MUST carry Resolves:, not Related:.

CI Debugging

Read ALL failing job logs, never guess; fix everything in one patchset. Locally:

./Build/Scripts/runTests.sh -s unit && ./Build/Scripts/runTests.sh -s functional
./Build/Scripts/cglFixMyCommit.sh && ./Build/Scripts/runTests.sh -s phpstan

Key Operations

TaskCommand
Push to Gerritgit push origin HEAD:refs/for/main%wip
Mark readygit push origin HEAD:refs/for/main%ready
Rebasegit fetch origin && git rebase origin/main
Cherry-pick patchgit fetch origin refs/changes/XX/NNNNN/N && git cherry-pick FETCH_HEAD
Install hookcp Build/git-hooks/commit-msg .git/hooks/ && chmod +x .git/hooks/commit-msg
Fix email mismatchGIT_COMMITTER_EMAIL="registered@email" git commit --amend --no-edit
Forge API${CLAUDE_SKILL_DIR}/scripts/create-forge-issue.sh, references/forge-api.md
t3o GitLabpython3 ${CLAUDE_SKILL_DIR}/scripts/t3o-gitlab.py access|issue|note|mr create|mr update|mr show|pipeline status|pipeline wait|link|probe

References

TopicFile
Account setupreferences/account-setup.md
Commit formatreferences/commit-message-format.md
Gerrit workflowreferences/gerrit-workflow.md
Review patternsreferences/gerrit-review-patterns.md
Modern patternsreferences/modern-typo3-patterns.md
DDEV setupreferences/ddev-setup-workflow.md
Forge APIreferences/forge-api.md
t3o sites on git.typo3.orgreferences/t3o-gitlab-workflow.md
Commit hookreferences/commit-msg-hook.md
Proving a testreferences/proving-a-test.md
Troubleshootingreferences/troubleshooting.md

Comments

Markdown supported