create-github-action-workflow-specification

SKILL.md

Generates formal, AI-optimized specifications for GitHub Actions workflows to standardize documentation and enable maintenance.

Produces structured markdown specifications with execution flow diagrams, job dependency matrices, and requirement tables designed for token efficiency

Covers functional, security, and performance requirements alongside input/output contracts, error handling strategies, and quality gates

Includes sections for monitoring, compliance, edge cases, and change management to support long-term workflow governance

Abstracts implementation details to focus on workflow behavior and constraints rather than specific syntax or tool versions

Create GitHub Actions Workflow Specification

Create a comprehensive specification for the GitHub Actions workflow: ${input:WorkflowFile}.

This specification serves as a specification for the workflow's behavior, requirements, and constraints. It must be implementation-agnostic, focusing on what the workflow accomplishes rather than how it's implemented.

AI-Optimized Requirements

Token Efficiency: Use concise language without sacrificing clarity

Structured Data: Leverage tables, lists, and diagrams for dense information

Semantic Clarity: Use precise terminology consistently throughout

Implementation Abstraction: Avoid specific syntax, commands, or tool versions

Maintainability: Design for easy updates as workflow evolves

Specification Template

Save as: /spec/spec-process-cicd-[workflow-name].md