GitHub Workflow Automation Skill

This skill provides comprehensive automation for GitHub issue management, pull request workflows, and WordPress-specific code validation.

Core Capabilities

1. Batch Issue Creation

Create multiple GitHub issues from structured data sources (JSON or CSV).

When to use:

• Converting audit results to issues
• Importing issues from spreadsheets
• Bulk issue creation from templates

How it works:

python scripts/batch_create_issues.py --input issues.json --repo owner/repo
python scripts/batch_create_issues.py --input issues.csv --format csv

See references/batch-issues-guide.md for detailed JSON/CSV schemas.

2. Automated PR Creation

Create pull requests from issues with automatic "Fixes #N" linking.

When to use:

• Converting issues to PRs with proper linking
• Automating PR workflow from feature branches
• Ensuring issue closure on PR merge

How it works:

python scripts/create_pr_from_issue.py --issue 123 --base main
python scripts/create_pr_from_issue.py --issue 456 --draft

See references/pr-workflow-guide.md for best practices.

3. Pre-PR Testing

Execute tests before creating pull requests to ensure code quality.

When to use:

• Before creating any PR
• As part of CI/CD pipeline
• Validating WordPress code changes

How it works:

bash scripts/run_tests.sh
bash scripts/run_tests.sh --verbose

Automatically detects: PHPUnit, pytest, npm test, WordPress test suite.

4. WordPress Validation

Run WordPress Coding Standards (PHPCS) checks with optional auto-fix.

When to use:

• Before committing WordPress PHP code
• Ensuring WPCS compliance
• Automated code quality gates

How it works:

bash scripts/validate_wordpress.sh
bash scripts/validate_wordpress.sh --fix
bash scripts/validate_wordpress.sh --standard WordPress-Extra

See references/wordpress-standards.md for configuration details.

Common Workflows

Workflow 1: Convert Website Audit to Issues

1. Create CSV/JSON file with audit findings
2. Validate input: python scripts/validate_input.py --input audit.json
3. Create issues: python scripts/batch_create_issues.py --input audit.json

Workflow 2: Issue-to-PR with Tests

1. Check GitHub health: bash scripts/gh_health_check.sh
2. Run tests: bash scripts/run_tests.sh
3. Create PR: python scripts/create_pr_from_issue.py --issue 123

Workflow 3: WordPress Code Contribution

1. Validate code: bash scripts/validate_wordpress.sh --fix
2. Run tests: bash scripts/run_tests.sh
3. Create PR: python scripts/create_pr_from_issue.py --issue 456

Scripts Reference

All scripts are in the scripts/ directory:

• batch_create_issues.py - Create multiple issues from JSON/CSV
• create_pr_from_issue.py - Create PR linked to issue(s)
• run_tests.sh - Execute test suites with auto-detection
• validate_wordpress.sh - Run PHPCS with WordPress standards
• validate_input.py - Validate JSON/CSV before processing
• gh_health_check.sh - Verify gh CLI authentication and permissions

Detailed References

For comprehensive documentation, see the references/ directory:

• batch-issues-guide.md - JSON/CSV schemas and examples
• wordpress-standards.md - WPCS configuration and best practices
• github-actions-integration.md - CI/CD workflow examples
• pr-workflow-guide.md - PR creation best practices
• error-handling.md - Common errors and solutions
• templates/ - Reusable issue and PR templates

Error Handling

All scripts include comprehensive error handling:

• Input validation before execution
• Clear error messages with suggested actions
• Graceful handling of rate limits
• Partial success support (continue on individual failures)

See references/error-handling.md for troubleshooting guidance.

Prerequisites

Required tools (scripts will check for these):

• gh CLI installed and authenticated
• Git configured
• For WordPress validation: phpcs with WPCS installed
• For testing: Appropriate test framework (PHPUnit, etc.)

Run health check: bash scripts/gh_health_check.sh

Examples

Create Issues from JSON

{
  "issues": [
    {
      "title": "Fix contact form",
      "body": "Contact form not submitting...",
      "labels": ["bug", "priority:high"],
      "assignees": ["username"]
    }
  ]
}

python scripts/batch_create_issues.py --input issues.json

Create PR with Multiple Issue Links

python scripts/create_pr_from_issue.py --issue 123,124,125 --base main

Validate and Auto-Fix WordPress Code

bash scripts/validate_wordpress.sh --fix --standard WordPress-Extra

Integration Points

This skill integrates with:

• GitHub CLI - All GitHub operations
• GitHub Actions - See references/github-actions-integration.md
• WordPress Coding Standards - Code quality enforcement
• Test Frameworks - Automated testing before PRs

Best Practices

1. Always validate input before batch operations
2. Run tests before creating PRs
3. Use dry-run mode to preview changes
4. Check health before starting workflows
5. Follow WordPress standards for all PHP code
6. Link PRs to issues using "Fixes #N" syntax
7. Review automated PRs even when tests pass

Troubleshooting

Scripts not executable?

chmod +x scripts/*.sh

gh CLI not authenticated?

gh auth login

PHPCS not found?

composer global require wp-coding-standards/wpcs
phpcs --config-set installed_paths ~/.composer/vendor/wp-coding-standards/wpcs

For more help, see references/error-handling.md.