GitLab Well Architected
Cookbook navigation

Catalog

Guides to custom and foundational flows, with their examples, included skills, and evaluation material kept together. Each guide walks from the scenario through setup and operation without depending on another catalog entry.

Cross project
AutonomousCI/CDModernizationPlatform engineeringCross-project

Find CI configurations that need attention, review proposed migrations, and plan the changes with the teams who own those pipelines.

AssignGitLab 19.4
Single project
Human in the loopComplianceCode reviewSecurity

Review a merge request against your project's compliance policy, with an explanation for each result, any checks still needed, and a suggested label.

Assign reviewer · Mention · Merge request readyGitLab 19.4
Single project
Human in the loopDocumentation

Find guides and runbooks left out of date by a code change, approve the suggested edits, and review the checked updates in a separate merge request.

Merge request ready · Assign · MentionGitLab 19.4
Single project
Human in the loopCI/CDPipeline troubleshootingSoftware development

Follow a failed pipeline through Duo's diagnosis, review its suggested fix, and check the next pipeline. Learn when a project setting is the better answer.

Start: Fix pipeline with DuoGitLab 19.4
Single project
Human in the loopFlow operations

Compare a proposed Flow change with a version you know works, review the test results, and decide whether to adopt it or restore the earlier version.

Merge request ready · MentionGitLab 19.4
Cross project
Human in the loopPlatform engineeringCI/CDGovernance

Find projects in a GitLab group whose CI includes don't match your team's policy, then review the findings before creating issues for their owners.

MentionGitLab 19.4
Single project
Human in the loopIncident response

Use incident observations and GitLab records to understand what happened and plan work to prevent it from happening again, while leaving production operations to your team.

MentionGitLab 19.4

Issue triage

Custom flow
Single project
AutonomousIssue management

Check whether an issue gives an agent enough information to start work, with suggestions for missing details grounded in the repository.

Mention · AssignGitLab 19.4
Cross project
Human in the loopPlatform engineeringModernizationCampaign management

Organize a migration across projects, approve each group of projects before its work begins, and track progress through their issues.

MentionGitLab 19.4
Single project
Human in the loopCode reviewAPI design

Compare Duo's review before and after adding project-specific instructions, then fix the issue and check the next review.

Start: Assign GitLab Duo as a reviewerGitLab 19.4
Single project
Human in the loopSoftware developmentIssue managementMerge requestsTesting

Turn a clear issue into a tested merge request, with a person reviewing the plan before implementation begins.

Mention · AssignGitLab 19.4

Zero-day fan-out

Custom flow
Cross project
Human in the loopSecurityIncident responseDependenciesnpm

Review an advisory across current dependency scans, keep missing checks visible, and approve follow-up issues before project owners make and verify repairs.

MentionGitLab 19.4
Cross project
Human in the loopArchitectureCode reviewCross-projectImpact analysisOrbit

Use GitLab Duo with Orbit to find callers, check what a library change means for them, and choose a useful regression test.

Development
DevelopmentCodingDeveloperGenerationTestingCreate

Delegate routine implementation to AI. Get working code with tests from requirements.

Code Review
Code ReviewAutomationCode-ReviewVerify

Get consistent, thorough code reviews at scale. Enforce patterns across all MRs automatically.

Code Quality
Code QualityCode-ReviewLintingReviewerStandardsVerify

Enforce team code style consistently across all MRs. Eliminate bikeshedding in reviews.

Code Quality
Code QualityCode-ReviewDatabaseMigrationPerformanceVerify

Review database migrations for safety, reversibility, and performance impact. Prevent production issues.

Code Review
Code ReviewCode-ReviewCollaborationDeveloperWorkflowVerify

Identify related open MRs that might conflict. Coordinate changes across team members.

Security
SecurityAutomationComplianceSecopsSecure

Catch compliance violations early before they block deployment. Pre-check for HIPAA, SOC2, GDPR.

Testing
TestingDeveloperQuality-AssuranceVerify

Analyze test coverage gaps and suggest specific test cases. Ensure critical paths are tested.

Code Understanding
Code UnderstandingAPIApiDeveloperDocumentationIntegrationCreate

Document how your system integrates with internal and external APIs. Prevents breaking changes in integrations.

Code Understanding
Code UnderstandingArchitectureDatabaseDeveloperOptimizationPerformanceCreate

Understand complex database schemas, relationships, and optimization opportunities. Identify performance bottlenecks in your data model.

Debugging
DebuggingAnalysisDeveloperMonitor

Parse complex stack traces to identify error origins and suggest fixes.

Planning & Architecture
Planning & ArchitectureArchitectArchitectureCollaborationDesignPlan

Challenge architectural assumptions collaboratively. Explore failure modes and scaling concerns.

Code Review
Code ReviewCode-ReviewQuality-AssuranceReviewerTestingVerify

Evaluate if an MR includes adequate tests for new functionality. Identify gaps before they reach production.

Enterprise
EnterpriseAuditingComplianceDocumentationSecopsSecurityGovern

Audit codebases for compliance violations. Check data handling, access controls, and encryption.

Documentation
DocumentationPlan

Transform large epics into manageable, well-scoped issues with clear dependencies and acceptance criteria.

Development
DevelopmentDeveloperFull-StackGenerationCreate

Scaffold complete applications with database schemas, API endpoints, and frontend components.

Code Review
Code ReviewCode-ReviewComplianceReviewerStandardsVerify

Ensure code follows team conventions and style guides. Consistent enforcement without tedious manual checks.

Code Review
Code ReviewArchitectureCode-ReviewDiscussionReviewerVerify

Understand design decisions and tradeoffs in MRs. Get context beyond just what changed.

Analytics
AnalyticsCode-SuggestionsReportingAdoptionAnalyze

Measure code suggestion adoption across baseline and rollout windows to track progress, compare acceptance rates, and identify trends by language and IDE.

Analytics
AnalyticsCode-SuggestionsReportingAnalyze

Compare code suggestion volume and acceptance rates across IDEs to see where developers are getting the most value from AI assistance. Visualise as a column chart.

Code Review
Code ReviewAnalysisArchitectArchitectureCode-ReviewDecision-MakingVerify

Compare implementation approaches with tradeoff analysis. Make informed decisions about performance vs maintainability.

Code Quality
Code QualityDeveloperDryRefactoringCreate

Identify and consolidate duplicate code into reusable components. Apply DRY principles systematically.

Enterprise
EnterpriseDevopsDocumentationPlanningReliabilityConfigure

Document recovery procedures with RTOs, backup strategies, and failover processes.

Documentation
DocumentationSupportWorkflowPlan

Convert support tickets into properly formatted, labeled issues. Streamline your support-to-development workflow.

Development
DevelopmentArchitectureDeveloperGenerationCreate

Create production-ready microservices with proper patterns, health checks, and containerization.

Security
SecurityArchitectureSecopsTestingSecure

Generate security-focused test cases for input validation, auth bypass, and injection attacks.

Planning & Architecture
Planning & ArchitectureArchitectArchitectureDocumentationPlanningPlan

Create comprehensive design documents with rationale, diagrams, and success criteria. Document decisions for posterity.

Support
SupportDebuggingDocumentationKnowledge-BaseMonitor

Create self-service troubleshooting guides with diagnostic steps and escalation criteria.

Debugging
DebuggingDeveloperMonitor

Find memory leaks by analyzing object lifecycles and retention issues.

Debugging
DebuggingConcurrencyDeveloperVerify

Identify race conditions in asynchronous code. Debug intermittent failures systematically.

Debugging
DebuggingDeveloperTestingWorkflowVerify

Track debugging hypotheses and test results systematically. Structured approach to complex bugs.

Planning & Architecture
Planning & ArchitectureAPIApiArchitectArchitectureDesignPlan

Define RESTful or GraphQL APIs with proper contracts, authentication, and error handling.

Planning & Architecture
Planning & ArchitectureArchitectArchitectureDesignPlanningPlan

Define architecture, components, and integration points for new features. Start projects with solid foundations.

GitLab Discovery
GitLab DiscoveryDeveloperDiscoveryOnboardingPlan

Explore GitLab capabilities you might not know about. Find features that match your needs.

Documentation
DocumentationPlan

Create memo including objectives and success criteria.

Planning & Architecture
Planning & ArchitectureArchitectureEstimationPlanningPlan

Break down work and estimate development time. Improve sprint planning accuracy.

Planning & Architecture
Planning & ArchitectureAnalysisArchitectArchitectureDecision-MakingPlan

Compare technologies or frameworks with structured tradeoff analysis. Make informed stack decisions.

Code Understanding
Code UnderstandingArchitectureDeveloperExplanationLearningLegacyCreate

Get step-by-step explanations of complex algorithms and legacy code. Learn the why behind the how.

Code Review
Code ReviewAnalysisCode-ReviewDeveloperPerformanceVerify

Assess how proposed changes will affect system performance. Catch complexity issues and bottlenecks early.

Testing
TestingDebuggingDeveloperVerify

Understand why tests fail, identify root causes, and determine if the code or test needs fixing.

Code Understanding
Code UnderstandingArchitectureCode-ReviewDeveloperExplanationOnboardingCreate

Get clear explanations of complex code or merge requests without manual investigation. Perfect for code reviews and onboarding.

Code Understanding
Code UnderstandingArchitectureDeveloperExplorationOnboardingCreate

Explore unfamiliar codebases conversationally. Understand architecture and key dependencies interactively.

Code Understanding
Code UnderstandingBest-PracticesDeveloperSearchCreate

Discover how specific patterns are implemented in your existing codebase. Learn from your team's established conventions.

GitLab Discovery
GitLab DiscoveryAPIApiAutomationDeveloperDiscoveryCreate

Discover correct API endpoints with parameters, authentication, and example requests.

Debugging
DebuggingAnalysisDeveloperVerify

Trace bugs from symptoms to root causes. Find where problems actually originate.

Code Understanding
Code UnderstandingDependency-MgmtDeveloperNavigationCreate

Navigate call graphs to understand how functions interconnect throughout your codebase. Reveals hidden dependencies instantly.

Enterprise
EnterpriseAutomationComplianceDocumentationReportingSecopsGovern

Generate audit-ready compliance reports with evidence and remediation status.

Automation
AutomationCI/CDCicdDevopsStandardizationRelease

Create reusable CI pipeline templates with security scanning and deployment strategies.

Documentation
DocumentationWorkflowPlan

Create standardized issue templates for bugs, features, and tasks. Ensure consistent issue quality.

Code Review
Code ReviewAutomationCode-ReviewDeveloperDocumentationTestingCreate

Auto-generate comprehensive MR descriptions including what changed, testing steps, and related issues.

Documentation
DocumentationAutomationRelease-MgmtRelease

Automatically compile release notes from merged MRs. Group changes by type: features, fixes, breaking changes.

Testing
TestingData-GenDeveloperVerify

Create realistic test datasets including valid records, edge cases, and boundary conditions.

Testing
TestingAutomationVerify

Generate comprehensive unit tests covering happy paths, edge cases, and error conditions automatically.

Code Review
Code ReviewAPIAnalysisApiCode-ReviewReviewerVerify

Detect if changes break existing APIs, contracts, or functionality. Prevent downstream breakages.

Code Understanding
Code UnderstandingDeveloperMaintenanceRefactoringCreate

Find similar code patterns that could be consolidated into shared utilities. Reduce maintenance burden through DRY principles.

Code Review
Code ReviewCode-ReviewSecopsSecuritySecure

Identify security vulnerabilities during code review. Catch SQL injection, XSS, and other risks early.

Development
DevelopmentArchitectureBest-PracticesDeveloperGenerationCreate

Apply design patterns correctly with complete implementations and usage examples.

Design & UX
Design & UXArchitecturePerformanceCreate

Make layouts work across all screen sizes with optimized touch targets and performance.

Design & UX
Design & UXAccessibilityArchitectureDeveloperRefactoringCreate

Add ARIA labels, keyboard navigation, and screen reader support. Meet WCAG 2.1 standards.

Analytics
AnalyticsReportingContributionsPerformance-ReviewAnalyze

Generate a structured summary of a user's contributions (MRs, reviews, work items) across one or more groups or projects for any review or reporting purpose.

Analytics
AnalyticsMerge-RequestsReportingAnalyze

Identify merge requests that have been open for more than 30 days to help teams reduce review bottlenecks and improve flow.

Code Understanding
Code UnderstandingAnalysisArchitectArchitectureDependency-MgmtCreate

Visualize how different components depend on each other. Understand the blast radius of potential changes.

Analytics
AnalyticsMerge-RequestsDuo-TrialReportingAnalyze

Get a directional read on merge request throughput during a GitLab Duo trial by comparing cohort vs non-cohort activity across baseline and trial windows.

Migration
MigrationAutomationDeveloperRefactoringCreate

Migrate code between frameworks while preserving functionality and adopting modern patterns.

Code Quality
Code QualityDeveloperLegacyRefactoringCreate

Update legacy code to use current language features and best practices. Modernize without breaking functionality.

Code Understanding
Code UnderstandingAPIDeveloperNavigationOnboardingCreate

Find relevant code sections in unfamiliar projects without knowing the structure. Accelerates exploration of new codebases.

Code Quality
Code QualityDeveloperOptimizationPerformanceCreate

Improve algorithmic efficiency while maintaining correctness. Optimize hot paths for performance gains.

Performance
PerformanceDatabaseDeveloperMonitor

Optimize slow queries with index suggestions and query rewrites. Improve database performance.

Embedded
EmbeddedDeveloperOptimizationPerformanceCreate

Optimize code for memory-constrained embedded devices. Balance performance and power consumption.

Analytics
AnalyticsPipelinesCI-CDReportingAnalyze

Compare CI pipeline reliability across all projects in a group to find which projects have the most pipeline failures.

Analytics
AnalyticsPipelinesCI-CDReportingChartsAnalyze

Chart how much CI activity your project is generating over time as a line chart, to spot capacity issues or unexpected dips.

Planning & Architecture
Planning & ArchitectureArchitectArchitectureDatabaseMigrationPlanningPlan

Design safe database migrations with rollback plans. Prevent data loss and minimize downtime.

Code Review
Code ReviewCode-ReviewDeveloperProductivityVerify

Categorize review comments by severity—critical blockers vs nice-to-have suggestions. Focus effort effectively.

Analytics
AnalyticsIssuesMerge-RequestsPipelinesCI-CDReportingDelivery-HealthAnalyze

Get a cross-cutting view of project delivery health combining work item flow, merge request throughput, and pipeline reliability into a single narrative.

Code Quality
Code QualityGeneralCreate

Break down complex functions into testable, maintainable components. Reduce cognitive load for future developers.

Code Quality
Code QualityClean-CodeDeveloperRefactoringCreate

Improve code readability with better names, simplified logic, and clearer structure. Make code self-documenting.

Code Quality
Code QualityCleanupDeveloperMaintenanceCreate

Find and safely remove unused code, deprecated methods, and commented-out blocks. Keep your codebase lean.

Code Review
Code ReviewCode-ReviewQuality-AssuranceReviewerTestingVerify

Catch logical errors and edge cases that syntax checkers miss. Go beyond linting to find real bugs.

Collaboration
CollaborationDebuggingDeveloperVerify

Explain problems systematically to reveal solutions. Always-available rubber duck debugging partner.

GitLab Discovery
GitLab DiscoveryDeveloperDiscoveryDocumentationGitlabPlan

Find relevant GitLab features and documentation for your specific use case.

Documentation
DocumentationPlan

Creates update for stakeholders based on the content of the work item.

Analytics
AnalyticsIssuesReportingTriageAnalyze

Surface open bug issues with no recent activity to help teams identify and act on work that may be falling through the cracks.

Code Review
Code ReviewAutomationCode-ReviewVerify

Receive actionable feedback on code quality, performance, and maintainability. Elevate your team's coding standards.

Code Review
Code ReviewCode-ReviewCollaborationDeveloperPerformanceWorkflowVerify

Identify the right reviewers based on code ownership and domain expertise. Route MRs efficiently.

Code Understanding
Code UnderstandingCollaborationExplanationReviewerCreate

Catch up on long-running MRs or issues by getting a summary of key decisions, changes, and action items.

Analytics
AnalyticsPipelinesReportingAnalyze

Identify the most frequently failing CI/CD jobs to help teams prioritize pipeline reliability improvements.

Code Understanding
Code UnderstandingAnalysisArchitectureDocumentationSecopsSecuritySecure

Map authentication flows and permission checks across your system. Essential for security audits and debugging access issues.

Code Understanding
Code UnderstandingDeveloperNavigationRefactoringCreate

Quickly locate all call sites for any method or function across your entire codebase. Invaluable when planning refactoring work.

Code Understanding
Code UnderstandingAnalysisDeveloperOnboardingRisk-MitigationCreate

Analyze code dependencies and potential impacts before modifying unfamiliar code sections. Essential for preventing breaking changes during refactoring.

Code Understanding
Code UnderstandingAnalysisArchitectCI/CDData-FlowCreate

Follow data as it moves through multiple components, tracking each transformation step. Essential for debugging data issues.

Code Understanding
Code UnderstandingDeveloperQuality-AssuranceStandardsCreate

Learn how errors are handled throughout your application. Identify inconsistencies and gaps in error handling.

8 files
CI/CDTestingTroubleshooting

A failed pipeline doesn't always mean the latest code change caused it. A passing retry might point to an intermittent test, a runner problem, or a service that recovered. Give this Skill the pipeline URL in a GitLab Duo, Claude, or Codex session with GitLab access. The agent reads the job attempts and logs, compares them with a relevant successful run when one exists, and recommends a check to narrow down the cause.

13 files
MigrationCI/CDAutomationGitHubVerifyBeginner

Add this free AI skill to your existing agent or AI tool (Cursor, VS Code, Claude, or any MCP-compatible client) and convert GitHub Actions workflows to GitLab CI/CD in seconds.

GitLab CI Skill

Standalone skill
28 files
AuthoringCI/CDAutomationDevOpsPipelinesVerifyBeginner

A free AI skill that drafts and validates GitLab CI pipelines directly in your local editor, including Cursor, VS Code, Claude Code, and any agent you already use.

Single project
Flow readinessHuman in the loopFlow operationsTestingIssue management

You've built a Flow that gives a good answer when you ask it to. Before letting everyday project activity start it automatically, try a few less convenient requests: an issue that's missing details, a comment that asks it to skip review, and an event that happens twice.