dotnet-gha-patterns

name	dotnet-gha-patterns
category	operations
subcategory	ci-cd
description	Composes GitHub Actions workflows. Reusable workflows, composite actions, matrix, caching.
license	MIT
targets	["*"]
tags	["cicd","dotnet","skill"]
version	0.0.1
author	dotnet-agent-harness
invocable	true
claudecode	{"allowed-tools":["Read","Grep","Glob","Bash","Write","Edit"]}
codexcli	{"short-description":".NET skill guidance for cicd tasks"}
opencode	{"allowed-tools":["Read","Grep","Glob","Bash","Write","Edit"]}
copilot	{}
geminicli	{}
antigravity	{}

dotnet-gha-patterns

Composable GitHub Actions workflow patterns for .NET projects: reusable workflows with workflow_call, composite actions for shared step sequences, matrix builds across TFMs and operating systems, path-based triggers, concurrency groups for duplicate run cancellation, environment protection rules, NuGet and SDK caching strategies, and workflow_dispatch inputs for manual triggers.

Version assumptions: GitHub Actions workflow syntax v2. actions/setup-dotnet@v4 for .NET 8/9/10 support. actions/cache@v4 for dependency caching.

Scope

• Reusable workflows with workflow_call
• Composite actions for shared step sequences
• Matrix builds across TFMs and operating systems
• Path-based triggers and concurrency groups
• NuGet and SDK caching strategies
• workflow_dispatch inputs for manual triggers

Out of scope

• Starter CI/CD templates -- see [skill:dotnet-add-ci]
• CLI release pipelines (tag-triggered build-package-release for CLI tools) -- see [skill:dotnet-cli-release-pipeline]
• Benchmark CI workflows -- see [skill:dotnet-ci-benchmarking]
• Azure DevOps pipeline patterns -- see [skill:dotnet-ado-patterns]
• Build/test specifics -- see [skill:dotnet-gha-build-test]
• Publishing workflows -- see [skill:dotnet-gha-publish]
• Deployment patterns -- see [skill:dotnet-gha-deploy]

Cross-references: [skill:dotnet-add-ci] for starter templates that these patterns extend, [skill:dotnet-cli-release-pipeline] for CLI-specific release automation, [skill:dotnet-ci-benchmarking] for benchmark-specific CI integration.

---

Reusable Workflows (workflow_call)

Defining a Reusable Workflow

Reusable workflows allow callers to invoke an entire workflow as a single step. Define inputs, outputs, and secrets for a clean contract:

# .github/workflows/build-reusable.yml
name: Build (Reusable)

on:
  workflow_call:
    inputs:
      dotnet-version:
        description: '.NET SDK version to install'
        required: false
         
         
      
         
         
         
         
      
         
         
         
    
      
         
           
    
      
         
         


  
     
    
         
    
        

         
         
        
             

        
             

        
                  

          
         
        
             
                      








 


  
     []
  
     []


  
     
    
       
       
    
         

  
     
     
    
       
       










  
     
    
       
      



                 
 






                 





 
 


  
     
     
     
  
     
     


   
  
        
       
      
           

        
       
      
         
              
         
       
       
           








  
     
    
        

          
         
        
           
           

        
              





                                              
      
                                             
                                           
                                     
                                            
                   









  
    
       
      
         [, , ]
         [, ]
        
            
             
        
            
             
       
    
        

            
         
        
             

        
        
                      
              



 

                 
   
         
        








  
     
    
         
    
        
        
         
         
  
     
    
         
     
    
        
             













  
     []
    
       
       
       
       
       
       
  
     []
    
       
       
       
       
       





  




  
     []
    
       
       
       
       



                
           











     
   











 []