Agent skill · Workflow & Productivity

create-github-action-workflow-specification

Create a formal specification for an existing GitHub Actions CI/CD workflow, optimized for AI consumption and workflow maintenance.

GitHub68,948★ · +463/wk · 2 repos on radarProfile →
copilotMIT
Install
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.

Facts
Files in the skill folder: 1
SKILL.md size: 7 KB
Bundled scripts: none
Path: skills/create-github-action-workflow-specification/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 37,432 · +281 this week
Language: Python

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the 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` ```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

What's inside
Steps it walks through
  1. AI-Optimized Requirements
  2. Specification Template
  3. Analysis Instructions
  4. Mermaid Diagram Guidelines
  5. Flow Types
  6. Styling
  7. Complex Workflows
  8. Token Optimization Strategies
More from awesome-copilot
All skills →
About this skill
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.

Keep going