What are GitHub Agentic Workflows (GH-AW)?

GH-AW are markdown-based workflow definitions (.md files) that allow AI agents to perform tasks within GitHub repositories securely and autonomously.

Do I need to compile workflows after editing?

Yes, when changing the frontmatter of a .md workflow, you must run 'gh aw compile' to regenerate the lock file, though markdown body changes do not require it.

What design patterns are supported by this skill?

The skill provides specific guidance for ChatOps, DailyOps, and other practice-proven patterns for agentic automation within the GitHub ecosystem.

How does this skill help with workflow security?

It enforces minimum-privilege access, provides guidance on safe-outputs, and helps configure strict mode to prevent unauthorized write access and ensure network calls are explicit.

Can it help with troubleshooting errors?

Yes, it includes specialized documentation and decision flows for common GH-AW errors, including permission denials and syntax issues in the frontmatter.

GitHub Agentic Workflow Best Practices

Name: GitHub Agentic Workflow Best Practices
Author: Suntory-N-Water

bySuntory-N-Water

0•

部署与 DevOps

Facilitates the creation, optimization, and troubleshooting of GitHub Agentic Workflows (.github/workflows/*.md) with a focus on security and frontmatter accuracy.

This skill provides comprehensive guidance for managing GitHub Agentic Workflows (GH-AW), allowing developers to build safe and effective agentic automations within GitHub. It offers expert advice on frontmatter syntax, permission scoping, design patterns like ChatOps and DailyOps, and security guardrails to ensure workflows are both powerful and secure. Whether you are setting up new workflows or debugging complex automation errors, this skill streamlines the process through reference guides and implementation best practices, ensuring your agentic automations are idempotent and follow the principle of least privilege.

主要功能

01Automated troubleshooting for GH-AW setup and execution errors

02Standardized frontmatter syntax validation for .md workflow files

030 GitHub stars

04Support for specialized design patterns including ChatOps and DailyOps

05Guidance on workflow compilation and idempotency to prevent duplicate actions

06Minimum-privilege permission design and security guardrail guidance

使用场景

01Generating new secure agentic workflows with proper frontmatter and permissions

02Optimizing existing GH-AW configurations to adhere to security standards

03Troubleshooting strict mode errors or network permission issues in GitHub workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add suntory-n-water/suntory-n-water-marketplace gh-aw-best-practice

For use in Claude.ai and ChatGPT

Download Skill