github-agentic-workflows

Authors, reviews, installs, and debugs GitHub Agentic Workflows in repositories, including workflow markdown, frontmatter, gh aw compile and run flows, safe outputs, security guardrails, and operational patterns. Use when creating or maintaining GH-AW automation. Don't use for standard deterministic GitHub Actions YAML, generic CI pipelines, or non-GitHub automation systems.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a well-structured, highly actionable workflow with explicit validation checkpoints, feedback loops, and clean progressive disclosure to real bundle files. The only minor weakness is length, where some conditional steps could be consolidated without losing clarity.

Suggestions

Consolidate the most conditional authoring rules (e.g., the network/reusable-workflow edge cases in Step 3) into the relevant reference files to trim the main procedure.

Consider a short top-of-file table of contents or mode-decision table so readers can jump to the relevant step instead of scanning all six.

Move version-specific notes (e.g., the `gh aw v0.58.3` field quirks in Error Handling) into `references/troubleshooting.md` to keep the main body version-agnostic and concise.

Dimension	Reasoning	Score
Conciseness	The body is dense with domain-specific operational gotchas Claude would not already know (e.g., trial path parsing, matrix concurrency groups) rather than padded concept explanations, but the sheer volume of conditional steps leaves some that could be tightened or consolidated, fitting the score-4 anchor better than 5.	4 / 5
Actionability	Provides copy-paste-ready, executable commands throughout ("node skills/github-agentic-workflows/scripts/find-gh-aw-targets.mjs .", "gh aw validate --strict", "gh aw trial ./.github/workflows/<workflow>.md") with specific paths and flags covering the common cases, matching the score-5 anchor.	5 / 5
Workflow Clarity	Six clearly sequenced steps with an explicit validation checkpoint in Step 5 ("Run `gh aw validate --strict` before treating a workflow as ready", compile only after validation succeeds) and a dedicated Error Handling section supplying fix-and-retry feedback loops, matching the score-5 anchor.	5 / 5
Progressive Disclosure	The body is an overview that points to real one-level-deep references signaled in context ("Read `references/authoring.md` before first-time repository setup", "Use `assets/workflow.template.md` as the base shape"), all of which exist as bundle files, matching the score-5 anchor.	5 / 5
	Total	19 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, complete, and well-bounded with a clear what/when pair and explicit exclusions. The only gap is the absence of file-extension/path trigger terms, which keeps trigger term quality at 4 rather than 5.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ("Authors, reviews, installs, and debugs") plus comprehensive coverage of feature areas (workflow markdown, frontmatter, compile/run flows, safe outputs, security guardrails, operational patterns), matching the score-5 anchor.	5 / 5
Completeness	Explicitly answers both what (author/review/install/debug plus feature scope) and when ("Use when creating or maintaining GH-AW automation") with concrete trigger phrases, and adds a negative boundary, matching the score-5 anchor.	5 / 5
Trigger Term Quality	Good keyword coverage with the synonym pair "GitHub Agentic Workflows" / "GH-AW automation" and "gh aw compile and run flows", but no file extensions (e.g., .md, .lock.yml) or path triggers, leaving a few natural terms missing per the score-4 anchor.	4 / 5
Distinctiveness Conflict Risk	Clear niche (GH-AW) with distinct triggers and an explicit exclusion clause ("Don't use for standard deterministic GitHub Actions YAML, generic CI pipelines, or non-GitHub automation systems"), giving minimal conflict risk per the score-5 anchor.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: webmaxru/web-ai-agent-skills
Path: .github/skills/github-agentic-workflows/SKILL.md
Commit: adc6b11

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.