Skip to content

SKILL.md

Latest commit

 

History

History
39 lines (27 loc) · 1.33 KB

SKILL.md

File metadata and controls

39 lines (27 loc) · 1.33 KB

gh-aw Prompt Surface

This repository builds gh-aw (GitHub Agentic Workflows), a GitHub CLI extension for writing workflows in markdown and compiling them to GitHub Actions.

What this surface does

  • Converts markdown workflow specs (.md) into compiled lock files (.lock.yml)
  • Supports multiple AI engines (copilot, claude, codex, custom)
  • Integrates tools, including GitHub MCP servers and safe-output tooling
  • Provides CLI commands to compile, run, inspect, and audit workflows

Key concepts

  1. Workflow compilation: edit workflow markdown, then recompile lock files
  2. Engine selection: set engine in frontmatter to control runtime agent behavior
  3. MCP tools: configure GitHub/MCP toolsets in frontmatter for repository operations
  4. Safe outputs: workflow-safe issue/comment output paths and constraints

Representative usage examples

# Compile markdown workflows to lock files
gh aw compile

# Run a workflow manually
gh aw run .github/workflows/daily-skill-optimizer.md

# Inspect MCP server usage in workflows
gh aw mcp list
gh aw mcp inspect daily-skill-optimizer

# Audit a workflow run
gh aw audit 24814681146

Where to learn more in this repo

  • /AGENTS.md for development/agent workflow conventions
  • /skills/*/SKILL.md for focused domain guidance (GitHub MCP, docs, errors, etc.)