Agent skill
matrix-distribution
Parallelize operations across dynamic target lists using GitHub Actions matrix strategies with failure isolation, rate limiting, and conditional logic.
Install this agent skill to your Project
npx add-skill https://github.com/adaptive-enforcement-lab/claude-skills/tree/main/plugins/patterns/skills/matrix-distribution
SKILL.md
Matrix Distribution
When to Use This Skill
Poor Fit
- Sequential operations where order matters
- Operations with shared state between targets
- When total job count would exceed GitHub Actions limits (256)
Implementation
Dynamic Matrix
Generate the target list in a discovery stage:
See examples.md for detailed code examples.
Failure Isolation
Prevent one failure from canceling other jobs:
strategy:
matrix:
target: ${{ fromJson(needs.discover.outputs.targets) }}
fail-fast: false # Critical: continue processing other targets
Rate Limiting
Control concurrency to avoid API rate limits:
strategy:
matrix:
target: ${{ fromJson(needs.discover.outputs.targets) }}
max-parallel: 10 # Limit concurrent jobs
Examples
See examples.md for code examples.
References
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
github-token-permissions-overview
Understanding GITHUB_TOKEN scope, default permissions, and implementing least-privilege principle for GitHub Actions workflows.
secure
Find and fix security issues before they become incidents. Vulnerability scanning, SBOM generation, supply chain security, and secure authentication workflows.
complete-workflow-examples
Copy-paste hardened CI/CD workflows with SHA-pinned actions, minimal GITHUB_TOKEN permissions, OIDC authentication, and comprehensive security scanning for GitHub Actions.
ephemeral-runner-patterns
Disposable runner patterns for GitHub Actions. Container-based, VM-based, and ARC deployment strategies with complete state isolation between jobs.
action-pinning-overview
Why pinning GitHub Actions to SHA-256 commits matters for supply chain security. Attack vectors from unpinned actions and comparison of tag vs SHA pinning.
github-actions-security-patterns-hub
Complete security patterns for GitHub Actions covering action pinning, GITHUB_TOKEN permissions, third-party action risks, secret management, and runner security.
Didn't find tool you were looking for?