gh-aw-compile

Recompile GitHub Agentic Workflow lock files from Markdown sources and verify with pre-commit hooks.

3|1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Cogni-AI-OU/cogni-ai-agent-skills --skill gh-aw-compile
Or copy as Structured Prompt for Agentā–¼
Please help me install this Agent Skill.
Skill: gh-aw-compile
Source: https://github.com/Cogni-AI-OU/cogni-ai-agent-skills/tree/main/gh-aw-compile
Command: npx skills add https://github.com/Cogni-AI-OU/cogni-ai-agent-skills --skill gh-aw-compile

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of keeping GitHub Agentic Workflow lock files in sync with their source workflow definitions, preventing broken or outdated automation.

Core Features & Use Cases

  • Workflow recompilation: Regenerates .lock.yml files from the managed .md workflow sources so actions and schemas match the current definitions.
  • Required post-change verification: Enforces running repository-standard pre-commit hooks after every lock file change to avoid a lint-failed or invalid state.
  • Schema/permissions validation: Helps detect compilation failures and schema-related warnings, guiding safe fixes to the source workflow files.

Quick Start

Use the gh-aw-compile skill to run gh aw compile and then execute pre-commit run --all-files to regenerate lock files and verify repository validity.

Frequently Asked Questions about gh-aw-compile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I regenerate GitHub workflow lock files after editing Markdown sources?ā–¼

To regenerate GitHub workflow lock files, run `gh aw compile` to recompile `.lock.yml` files from managed `.md` workflow sources, ensuring your automation actions and schemas match the current definitions.

What is the process to validate schema and permissions for agentic workflows?ā–¼

Schema and permissions validation for agentic workflows is performed by recompiling lock files via `gh aw compile` or `gh aw upgrade`, which detects compilation failures and schema warnings to guide safe fixes to source files.

Do I need to run pre-commit hooks after recompiling workflow lock files?ā–¼

Yes, running repository-standard pre-commit hooks via `pre-commit run --all-files` is required after recompiling workflow lock files to verify repository validity and avoid a lint-failed or invalid state.

When should I recompile lock files for GitHub workflows?ā–¼

You should recompile lock files for GitHub workflows whenever workflow `.md` files change, when upgrading gh-aw action definitions, or when schema validation is required to prevent broken or outdated automation.

Why are my agentic workflow lock files out of sync with source definitions?ā–¼

Agentic workflow lock files become out of sync when source `.md` workflow definitions are modified without running `gh aw compile`, causing actions and schemas to mismatch and leading to broken or outdated automation.