create-github-action-workflow-specification

What problem does it solve?

This Skill removes ambiguity around GitHub Actions workflows by producing a single, implementation-agnostic specification that documents purpose, triggers, job flows, inputs/outputs, constraints, and recovery strategies to aid maintenance and review.

Core Features & Use Cases

• Specification Template: Produces a structured spec with metadata, overview, job dependency diagrams, requirements matrices, inputs/outputs contracts, and change history.
• Behavioral Abstraction: Focuses on what the workflow achieves (triggers, intent, constraints, quality gates) rather than implementation details or exact commands.
• Use Case: Useful for onboarding new engineers, performing audits, creating runbooks, or converting informal CI scripts into maintainable process docs.

Quick Start

Draft an implementation-agnostic specification for the GitHub Actions workflow file named .github/workflows/ci.yml.