Agent skill · software engineering · github
create-github-action-workflow-specification
Create a formal specification for an existing GitHub Actions CI/CD workflow, optimized for AI consumption and workflow maintenance.
Why this skill is useful
Provides a structured template for documenting GitHub Actions workflows, which includes domain-specific requirements and constraints not typically known to the AI.
What it needs
About 4k tokens when loaded. Last updated 2026-08-07. 37,534 stars on the source repository.
What this skill does
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 mermaid graph TD A[Trigger Event] --> B[Job 1] B --> C[Job 2] C --> D[Job 3] D --> E[End] B --> F[Parallel Job] F --> D style A fill:#e1f5fe style E fill:#e8f5e8 yaml Environment Variables ENVVAR1: string # Purpose: [description] ENVVAR2: secret # Purpose: [description] Repository Triggers paths: [list of path filters] branches: [list of branch patterns] yaml Job Outputs job1output: string # Description: [purpose] buildartifact: file # Description: [content type] Analysis Instructions When analyzing the workflow file: 1. Extract Core Purpose: Identify the primary business objective 2. Map Job Flow: Create dependency graph showing execution order 3. Identify Contracts: Document inputs, outputs, and interfaces 4. Capture Constraints: Extract timeouts, permissions, and limits 5. Define Quality Gates: Identify validation and approval points 6. Document Error Paths: Map failure scenarios and recovery 7. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills github/create-github-action-workflow-specification