Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
Use this skill when you need to debug GitHub Actions workflows, download workflow logs or summaries, or understand how agentic workflows and the AWF firewall work together.
Quick Start
Download Workflow Logs
Use the download-workflow-logs.ts script to download logs from a workflow run:
# Download logs from the latest workflow run
npx tsx .github/skills/debugging-workflows/download-workflow-logs.ts
# Download logs from a specific run ID
npx tsx .github/skills/debugging-workflows/download-workflow-logs.ts --run-id 1234567890
# Download logs from a specific workflow
npx tsx .github/skills/debugging-workflows/download-workflow-logs.ts --workflow test-integration.yml
# Save logs to a specific directory
npx tsx .github/skills/debugging-workflows/download-workflow-logs.ts --output ./my-logs
Download Workflow Summary
Use the download-workflow-summary.ts script to get a summary of workflow runs:
# Get summary of latest workflow runs
npx tsx .github/skills/debugging-workflows/download-workflow-summary.ts
# Get summary for a specific workflow run
npx tsx .github/skills/debugging-workflows/download-workflow-summary.ts --run-id 1234567890
npx tsx .github/skills/debugging-workflows/download-workflow-summary.ts --workflow test-integration.yml
npx tsx .github/skills/debugging-workflows/download-workflow-summary.ts --format json
# Get summary for a specific workflow file
# Get summary as JSON
GitHub CLI Commands
The gh CLI is essential for debugging workflows. Here are the most useful commands:
List Workflow Runs
# List recent workflow runs
gh run list --limit 10
# List runs for a specific workflow
gh run list --workflow test-integration.yml --limit 10
# List only failed runs
gh run list --status failure --limit 10
# List runs in JSON format for parsing
gh run list --json databaseId,name,status,conclusion,createdAt --limit 10
View Workflow Run Details
# View a specific run
gh run view <run-id>
# View run with job details
gh run view <run-id> --verbose
# View run as JSON
gh run view <run-id> --json jobs,conclusion,status
Download Run Logs
# Download all logs for a run
gh run download <run-id>
# Download specific artifact
gh run download <run-id> --name <artifact-name>
# Download to specific directory
gh run download <run-id> --dir ./logs
Watch a Running Workflow
# Watch a workflow run in real-time
gh run watch <run-id>
# Watch with exit code (useful for CI)
gh run watch <run-id> --exit-status
Re-run Failed Jobs
# Re-run failed jobs only
gh run rerun <run-id> --failed
# Re-run all jobs
gh run rerun <run-id>
Understanding Agentic Workflows
What are Agentic Workflows?
Agentic workflows are GitHub Actions workflows that use AI agents (like GitHub Copilot or Claude) to perform tasks. They are defined using markdown + YAML frontmatter format in .github/workflows/*.md files and compiled to GitHub Actions YAML (.lock.yml files).
Key Components
Workflow File Format: .github/workflows/<name>.md
YAML frontmatter for configuration
Markdown body for AI instructions
Compiles to .github/workflows/<name>.lock.yml
Triggers (on: field):
Standard GitHub events: issues, pull_request, push, schedule
Command triggers: /mention in issues/comments
workflow_dispatch for manual triggers
Safe Outputs: Controlled way for AI to create GitHub entities
create-issue: - Create GitHub issues
create-pull-request: - Create PRs with git patches
add-comment: - Add comments to issues/PRs
add-labels: - Add labels to issues/PRs
create-discussion: - Create GitHub discussions
Tools Configuration (tools: field):
github: - GitHub API tools
agentic-workflows: - Workflow introspection tools
edit: - File editing tools
web-fetch: / web-search: - Web access tools
bash: - Shell command tools
Compiling Workflows
# Compile all workflows
gh aw compile
# Compile a specific workflow
gh aw compile <workflow-name>
# Compile with strict security checks
gh aw compile --strict
Debugging Agentic Workflows
# View status of all agentic workflows
gh aw status
# Download and analyze logs from previous runs
gh aw logs <workflow-name> --json
# Audit a specific run for issues
gh aw audit <run-id> --json
Common Issues
Missing Tool Calls: Check missing_tools in audit output
Permission Issues: Verify permissions: block in frontmatter
Network Blocked: Check network: configuration for allowed domains
Understanding the AWF Firewall
What is AWF?
AWF (Agent Workflow Firewall) is a tool that provides L7 (HTTP/HTTPS) egress control for GitHub Copilot CLI and other agents. It restricts network access to a whitelist of approved domains using Squid proxy and Docker containers.
