emasoft/amia-github-pr-workflow
skills/amia-github-pr-workflow/SKILL.md
Use when coordinating PR review work as orchestrator. Defines delegation rules, verification, and completion criteria. Trigger with /start-pr-review [PR_NUMBER]. Loaded by ai-maestro-integrator-agent-main-agent.
data-ai
Updated Apr 28, 2026
$ install --global
skillsauthnpx skillsauth add emasoft/ai-maestro-integrator-agent amia-github-pr-workflowInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 28, 2026, 5:03 AM188.4s21 files scanned
SKILL.md
- name:
- amia-github-pr-workflow
- description:
- Use when coordinating PR review work as orchestrator. Defines delegation rules, verification, and completion criteria. Trigger with /start-pr-review [PR_NUMBER]. Loaded by ai-maestro-integrator-agent-main-agent.
- license:
- Apache-2.0
- compatibility:
- Requires AI Maestro installed.
- tags:
- pr-review, orchestration, delegation, verification, github
- version:
- 1.0.0
- author:
- Emasoft
- category:
- workflow
- agent:
- api-coordinator
- context:
- fork
- user-invocable:
- false
Orchestrator PR Workflow Skill
Overview
Orchestrator workflow for delegating PR reviews to subagents, verifying completion, and reporting to user.
Prerequisites
- GitHub CLI (
gh) authenticated - Python 3.8+ and AI Maestro configured
- Subagent spawning capability
Instructions
- Poll -- Run
amia_orchestrator_pr_poll.pyto get open PRs - Classify -- Human PR = escalate; AI/bot PR = delegate directly
- Delegate -- Spawn subagent for review/changes (never do work yourself)
- Monitor -- Poll progress via background tasks (never block)
- Verify -- Run
amia_verify_pr_completion.pybefore reporting
Checklist
Copy this checklist and track your progress:
- [ ] Poll PRs using
amia_orchestrator_pr_poll.py - [ ] Classify author type and work needed
- [ ] Delegate to subagent
- [ ] Monitor and verify using
amia_verify_pr_completion.py - [ ] Report to user, await merge decision
- [ ] Handle failures by delegating fixes
Critical Rules
- Never block, write code, or merge without user approval
- Always verify before reporting status
- Escalate human PRs to user
Output
| Output Type | Format | Description | |---|---|---| | Subagent Delegation | Task spawn | Spawned subagent with PR review/fix instructions | | Status Report | Text/JSON | Current PR status and action recommendations | | Verification Result | JSON | Pass/fail status for all completion criteria | | User Notification | Text | Human-readable summary of PR readiness |
Output discipline: All scripts support
--output-file <path>. Use it to minimize token consumption.
Error Handling
Script failures return non-zero exit codes. See the detailed guide in Resources for details.
Examples
python scripts/amia_orchestrator_pr_poll.py --repo owner/repo
python scripts/amia_verify_pr_completion.py --repo owner/repo --pr 123
# Output: {"complete": true, "recommendation": "ready_to_merge"}
Resources
Full index in detailed-guide:
- Decision Tree
- Scripts Reference
- amia_orchestrator_pr_poll.py
- amia_verify_pr_completion.py
- Section Index
-
- Orchestrator Responsibilities
-
- Delegation Rules
-
- Verification Workflow
-
- Worktree Coordination
-
- Human vs AI PR Assignment
-
- Completion Criteria
-
- Polling Schedule
-
- Merge Failure Recovery
-
- Error Handling
- Subagent not returning results
- PR status appears stale
- Completion verification fails intermittently
- Multiple subagents conflicting
- User not receiving status updates
- Extended Examples
- Example 1: Standard PR Review Coordination
- Example 2: Verify PR is Ready to Merge
- Full Reference Documents Index
Related Skills
emasoft/amia-tdd-enforcement
development
VerifiedTrustedCommunity
Use when enforcing TDD via RED-GREEN-REFACTOR. No production code without a failing test first. Trigger with /enforce-tdd. Loaded by ai-maestro-integrator-agent-main-agent.
SKILL.mdUpdated Apr 4, 2026
emasoft/amia-session-memory
data-ai
VerifiedTrustedCommunity
Use when resuming sessions. Trigger with session resumption. Loaded by ai-maestro-integrator-agent-main-agent.
SKILL.mdUpdated Apr 4, 2026
emasoft/amia-release-management
devops
VerifiedTrustedCommunity
Software release management and coordination. Use when creating releases, bumping versions, or rolling back deployments. Trigger with release tasks or /amia-create-release. Loaded by ai-maestro-integrator-agent-main-agent.
SKILL.mdUpdated Apr 4, 2026
emasoft/amia-quality-gates
testing
VerifiedTrustedCommunity
Use when enforcing quality gates. Trigger with /amia-enforce-gates. Loaded by ai-maestro-integrator-agent-main-agent.
SKILL.mdUpdated Apr 4, 2026