create-github-action-workflow-specification
Create a formal specification for an existing GitHub Actions CI/CD workflow, optimized for AI consumption and workflow maintenance.
npx skills add github/awesome-copilot --skill create-github-action-workflow-specification --agent copilot
Same command for any agent — swap --agent for claude-code, codex, cursor.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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` ```md --- title: CI/CD Workflow Specification - [Workflow Name] version: 1.0 date_created: [YYYY-MM-DD] last_updated: [YYYY-MM-DD] owner: DevOps Team tags: [process, cicd, github-actions, automation, [domain-specific-tags]] --- ## Workflow Overview **Purpose**: [One sentence describing workflow's primary goal] **Trigger Events**: [List trigger
- AI-Optimized Requirements
- Specification Template
- Analysis Instructions
- Mermaid Diagram Guidelines
- Flow Types
- Styling
- Complex Workflows
- Token Optimization Strategies
What does the create-github-action-workflow-specification skill do?
Create a formal specification for an existing GitHub Actions CI/CD workflow, optimized for AI consumption and workflow maintenance.
How do I install it?
Run `npx skills add github/awesome-copilot --skill create-github-action-workflow-specification --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From github/awesome-copilot, a repository with 37,432 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.