Agent skill
matrix-filtering-and-deduplication
Reduce matrix builds from 47 jobs to 3 with path filtering, deduplication, and dynamic generation. Run only what changed and eliminate redundant combinations.
Install this agent skill to your Project
npx add-skill https://github.com/adaptive-enforcement-lab/claude-skills/tree/main/plugins/patterns/skills/matrix-filtering-and-deduplication
SKILL.md
Matrix Filtering and Deduplication
When to Use This Skill
| Pattern | Use Case | Complexity |
|---|---|---|
| Path Filters | Single workflow, simple triggers | Low |
| Dynamic Matrix | Monorepo, many services | Medium |
| Dorny Paths Filter | Shared dependencies, cross-cutting changes | Low |
| Deduplication | Overlapping test configurations | Low |
| Conditional Expansion | Different rigor per event (push vs PR) | Medium |
| Directory Discovery | Auto-scaling as repo grows | Medium |
| Dependency Tracking | Expensive vendor/build operations | Low |
| Fast-Fail | Critical checks vs optional validations | Low |
| Caching | Deterministic builds | Medium |
| Artifacts | Build once, test many | Low |
| Combined Filters | Maximum work avoidance | High |
Implementation
See the full implementation guide in the source documentation.
Comparison
| Scenario | Static Matrix | Dynamic Matrix | Savings |
|---|---|---|---|
| 10 services, 1 changed | 10 jobs | 1 job | 90% |
| 5 charts, 2 changed | 10 jobs (lint+test) | 4 jobs | 60% |
| 3 platforms, code unchanged (cached) | 3 builds | 0 builds | 100% |
| Monorepo with 20 microservices | 20 jobs | 3 jobs (avg) | 85% |
Examples
See examples.md for code examples.
Troubleshooting
See troubleshooting.md for common issues and solutions.
Related Patterns
- Work Avoidance
- Hub and Spoke
- Idempotency
References
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
adaptive-enforcement-lab/claude-skills
github-token-permissions-overview
Understanding GITHUB_TOKEN scope, default permissions, and implementing least-privilege principle for GitHub Actions workflows.
adaptive-enforcement-lab/claude-skills
secure
Find and fix security issues before they become incidents. Vulnerability scanning, SBOM generation, supply chain security, and secure authentication workflows.
adaptive-enforcement-lab/claude-skills
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.
adaptive-enforcement-lab/claude-skills
ephemeral-runner-patterns
Disposable runner patterns for GitHub Actions. Container-based, VM-based, and ARC deployment strategies with complete state isolation between jobs.
adaptive-enforcement-lab/claude-skills
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.
adaptive-enforcement-lab/claude-skills
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?