create-github-action-workflow-specification
Installation
Summary
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
SKILL.md
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