Agent skill
file-distribution
Automated file distribution across multiple repositories with three-stage workflow. Discovery, parallel distribution, and summary reporting for consistent updates.
Install this agent skill to your Project
npx add-skill https://github.com/adaptive-enforcement-lab/claude-skills/tree/main/plugins/patterns/skills/file-distribution
SKILL.md
File Distribution
When to Use This Skill
Automated file distribution across multiple repositories using GitHub Actions and GitHub Apps.
Pattern Overview
A three-stage workflow that discovers targets, distributes files in parallel, and reports results. Idempotent design ensures safe reruns.
Prerequisites
- GitHub App Setup - Organization-level GitHub App
- Actions Integration - Token generation in workflows
Implementation
Core Workflow
- Architecture - Three-stage workflow overview
- Stage 1: Discovery - Query organization for target repositories
- Stage 2: Distribution - Parallel distribution to each repository
- Stage 3: Summary - Aggregate and display results
Configuration
- Workflow Configuration - Triggers and permissions
- Supporting Scripts - Branch preparation and helper scripts
Reliability
- Idempotency - Safe re-execution guarantees
- Error Handling - Failure strategies and reporting
- Troubleshooting - Common issues and solutions
Extensions
- Extension Patterns - Multi-file, conditional, and template distribution
Operations
- Performance - Parallel processing and rate limits
- Monitoring - Workflow summaries and metrics
- Security - Token scope and audit trails
Key Principles
- Start Small - Test with 2-3 repositories before full rollout
- Monitor First Run - Watch logs carefully on initial deployment
- Gradual Rollout - Increase
max-parallelgradually - Clear Documentation - Document what files are distributed and why
- Review Process - Ensure PRs are reviewed before merging
Techniques
Patterns Applied
This workflow implements patterns from the Developer Guide:
| Pattern | Purpose |
|---|---|
| Three-Stage Design | Separates discovery, execution, and reporting |
| Matrix Distribution | Parallelizes operations with conditional logic |
| Idempotency | Ensures safe reruns after partial failures |
| Work Avoidance | Skips version-only changes |
Troubleshooting
See troubleshooting.md for common issues and solutions.
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?