{"id":44038419,"url":"https://github.com/netresearch/typo3-core-contributions-skill","last_synced_at":"2026-04-22T12:01:15.356Z","repository":{"id":321206736,"uuid":"1084257023","full_name":"netresearch/typo3-core-contributions-skill","owner":"netresearch","description":"Agent Skill for TYPO3 Core contributions - Gerrit workflow, CI/CD, quality automation | Claude Code compatible","archived":false,"fork":false,"pushed_at":"2026-04-19T09:04:14.000Z","size":171,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-19T11:13:39.521Z","etag":null,"topics":["agent-skills","ai-agent","claude-code-skill","contribution","gerrit","open-standard","skill","typo3","typo3-cms"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netresearch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-CC-BY-SA-4.0","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-27T12:47:18.000Z","updated_at":"2026-04-19T09:04:18.000Z","dependencies_parsed_at":"2026-02-20T16:00:58.815Z","dependency_job_id":null,"html_url":"https://github.com/netresearch/typo3-core-contributions-skill","commit_stats":null,"previous_names":["netresearch/typo3-core-contributions-skill"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/netresearch/typo3-core-contributions-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Ftypo3-core-contributions-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Ftypo3-core-contributions-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Ftypo3-core-contributions-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Ftypo3-core-contributions-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netresearch","download_url":"https://codeload.github.com/netresearch/typo3-core-contributions-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Ftypo3-core-contributions-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32135189,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T08:34:57.708Z","status":"ssl_error","status_checked_at":"2026-04-22T08:34:55.583Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agent","claude-code-skill","contribution","gerrit","open-standard","skill","typo3","typo3-cms"],"created_at":"2026-02-07T20:12:41.121Z","updated_at":"2026-04-22T12:01:10.338Z","avatar_url":"https://github.com/netresearch.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TYPO3 Core Contributions Skill\n\nAn AI skill for guiding contributions to TYPO3 Core through systematic workflows, automated quality checks, and best practices enforcement.\n\n## 🔌 Compatibility\n\nThis is an **Agent Skill** following the [open standard](https://agentskills.io) originally developed by Anthropic and released for cross-platform use.\n\n**Supported Platforms:**\n- ✅ Claude Code (Anthropic)\n- ✅ Cursor\n- ✅ GitHub Copilot\n- ✅ Other skills-compatible AI agents\n\n\u003e Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.\n\n\n## Overview\n\nThis skill provides comprehensive guidance for contributing to TYPO3 Core, including:\n\n- **Gerrit-based code review workflow**\n- **Automated CI/CD debugging**\n- **Commit message formatting**\n- **WIP (Work in Progress) state management**\n- **Testing and quality assurance**\n- **Account setup and prerequisites**\n\n## Features\n\n### 🔄 Complete Contribution Workflow\n- Step-by-step guidance from setup to patch submission\n- Automated detection of common issues\n- Best practices enforcement at every stage\n\n### 🤖 CI/CD Integration\n- Systematic debugging of failed GitLab CI jobs\n- Pattern recognition for common failures\n- Automated fix suggestions\n\n### ✅ Quality Gates\n- Pre-submission validation\n- Code style enforcement (CGL)\n- PHPStan static analysis\n- Comprehensive test coverage\n\n### 📝 Documentation\n- Gerrit workflow reference\n- Commit message format guidelines\n- Troubleshooting guide with 60+ scenarios\n- WIP state management\n\n## Quick Start\n\n### Prerequisites\n\nEnsure you have:\n- Git configured with your TYPO3.org email\n- SSH key uploaded to review.typo3.org\n- Docker (for DDEV) or native PHP 8.2+ environment\n\n## Installation\n\n### Marketplace (Recommended)\n\nAdd the [Netresearch marketplace](https://github.com/netresearch/claude-code-marketplace) once, then browse and install skills:\n\n```bash\n# Claude Code\n/plugin marketplace add netresearch/claude-code-marketplace\n```\n\n### npx ([skills.sh](https://skills.sh))\n\nInstall with any [Agent Skills](https://agentskills.io)-compatible agent:\n\n```bash\nnpx skills add https://github.com/netresearch/typo3-core-contributions-skill --skill typo3-core-contributions\n```\n\n### Download Release\n\nDownload the [latest release](https://github.com/netresearch/typo3-core-contributions-skill/releases/latest) and extract to your agent's skills directory.\n\n### Git Clone\n\n```bash\ngit clone https://github.com/netresearch/typo3-core-contributions-skill.git\n```\n\n### Composer (PHP Projects)\n\n```bash\ncomposer require netresearch/typo3-core-contributions-skill\n```\n\nRequires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).\n## Scope\n\n**This skill covers**: TYPO3 Core code contributions (PHP, JavaScript, CSS, tests)\n- Submission via Gerrit (review.typo3.org)\n- Git commit-msg hooks and validation\n- Forge issue tracking\n- GitLab CI/CD pipeline\n\n**Not covered**: TYPO3 Documentation contributions\n- For documentation work, use: https://github.com/netresearch/typo3-docs-skill\n- Documentation uses GitHub Pull Requests, not Gerrit\n- Different format (reStructuredText) and workflows\n\n## Directory Structure\n\n```\ntypo3-core-contributions/\n├── SKILL.md                      # Main skill definition\n├── README.md                     # This file\n├── references/\n│   ├── account-setup.md          # Prerequisites and account configuration\n│   ├── commit-message-format.md  # Commit message standards\n│   ├── ddev-setup-workflow.md    # DDEV environment setup\n│   ├── gerrit-workflow.md        # Complete Gerrit submission workflow\n│   └── troubleshooting.md        # 60+ troubleshooting scenarios\n├── scripts/\n│   ├── setup-typo3-coredev.sh    # Automated environment setup\n│   └── verify-prerequisites.sh   # Prerequisites checker\n└── assets/\n    └── images/                   # Workflow diagrams and screenshots\n```\n\n## Key Workflows\n\n### 1. Initial Setup\n\n```bash\n# Verify prerequisites\n./scripts/verify-prerequisites.sh\n\n# Setup TYPO3 Core development environment\n./scripts/setup-typo3-coredev.sh\n```\n\n### 2. Create Patch\n\n```bash\n# Create feature branch\ngit checkout -b feature/issue-number-description\n\n# Make changes, commit with proper format\ngit commit -m \"[BUGFIX] Fix indexed search null handling\n\nResolves: #105737\nReleases: main\"\n```\n\n### 3. Submit to Gerrit\n\n```bash\n# Submit as WIP (Work in Progress)\ngit push origin HEAD:refs/for/main%wip\n\n# After CI passes, mark as ready\ngit commit --amend --allow-empty --no-edit\ngit push origin HEAD:refs/for/main%ready\n```\n\n### 4. Handle CI Failures\n\nThe skill provides systematic debugging:\n1. Check ALL failed job logs\n2. Identify failure patterns (cgl, phpstan, unit tests)\n3. Fix all issues in ONE patchset\n4. Re-submit and verify\n\n## WIP State Management\n\n### Command-Line Approach (Recommended)\n\n```bash\n# Set WIP state\ngit push origin HEAD:refs/for/main%wip\n\n# Remove WIP state\ngit commit --amend --allow-empty --no-edit\ngit push origin HEAD:refs/for/main%ready\n```\n\n### Web UI Alternative\n\nOpen review URL and click \"Start Review\" button.\n\n**Note**: SSH `gerrit review` command does NOT support WIP flags.\n\n## Commit Message Format\n\nRequired structure:\n\n```\n[TYPE] Short description (max 52 chars)\n\nExtended description explaining the why and how.\n\nResolves: #12345\nReleases: main, 12.4\n```\n\n**Types**: BUGFIX, FEATURE, TASK, DOCS, CLEANUP, SECURITY\n\n**Required**: At least one `Resolves:` line\n\n**Optional**: `Related:` (but cannot be used alone)\n\n## CI/CD Debugging\n\nCommon failure patterns:\n\n### CGL (Code Style)\n```bash\nBuild/Scripts/cglFixMyCommit.sh\ngit commit --amend --no-edit\n```\n\n### PHPStan\n```bash\nBuild/Scripts/runTests.sh -s phpstan\n# Fix reported issues\n```\n\n### Unit Tests\n```bash\nBuild/Scripts/runTests.sh -s unit path/to/test\n# Fix test failures\n```\n\n## Troubleshooting\n\nThe skill includes comprehensive troubleshooting for:\n\n- **Account Issues**: Email mismatch, SSH authentication, commit-msg hook\n- **CI Failures**: CGL, PHPStan, unit tests, functional tests\n- **Gerrit Issues**: WIP state, patch conflicts, rebase requirements\n- **Testing Issues**: Test failures, coverage gaps, fixture setup\n- **Code Quality**: Naming conventions, type safety, defensive programming\n\nSee `references/troubleshooting.md` for detailed solutions.\n\n## Real-World Testing\n\nThis skill was developed and validated through:\n\n- **Forge Issue #105737**: TypeError in indexed search\n- **7 patchsets** with iterative CI debugging\n- **GitHub PR #397**: Documentation improvements\n- **Live Gerrit testing**: WIP workflow validation\n\nAll workflows have been tested on actual TYPO3 Core submissions.\n\n## Updates and Enhancements\n\nRecent additions:\n\n### v1.1.0 (2025-10-27)\n- ✅ WIP state management (command-line and web UI)\n- ✅ CI failure investigation protocol (423 lines)\n- ✅ Comprehensive troubleshooting guide (60+ scenarios)\n- ✅ PHPStan error guidance\n- ✅ Code style enforcement patterns\n- ✅ Documentation scope clarification\n\n## Contributing\n\nTo improve this skill:\n\n1. Test on real TYPO3 Core contributions\n2. Document edge cases in troubleshooting guide\n3. Add automation scripts for common tasks\n4. Validate against official TYPO3 documentation\n\n## Resources\n\n### Official TYPO3 Documentation\n- [Contribution Guide](https://docs.typo3.org/m/typo3/guide-contributionworkflow/main/en-us/)\n- [Gerrit Documentation](https://gerrit-review.googlesource.com/Documentation/user-upload.html)\n- [TYPO3 Forge](https://forge.typo3.org/)\n\n### Related Skills\n- [TYPO3 Docs Skill](https://github.com/netresearch/typo3-docs-skill) - For documentation contributions\n\n## License\n\nThis project uses split licensing:\n\n- **Code** (scripts, workflows, configs): [MIT](LICENSE-MIT)\n- **Content** (skill definitions, documentation, references): [CC-BY-SA-4.0](LICENSE-CC-BY-SA-4.0)\n\nSee the individual license files for full terms.\n## Author\n\nCreated for use with Claude Code and TYPO3 Core contributions.\n\nMaintained by: Netresearch DTT GmbH\n\n## Support\n\nFor issues or questions:\n- Open an issue in this repository\n- Reference official TYPO3 documentation\n- Test workflows on live Gerrit instance\n\n---\n\n**Version**: 1.1.0\n**Last Updated**: 2025-10-27\n**Status**: Production-ready, validated on live submissions\n\n---\n\n**Made with ❤️ for Open Source by [Netresearch](https://www.netresearch.de/)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Ftypo3-core-contributions-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetresearch%2Ftypo3-core-contributions-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Ftypo3-core-contributions-skill/lists"}