CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

77

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

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.

A strong operational skill body: highly actionable CLI commands, a well-sequenced six-step procedure with explicit validation gates, and clean conditional navigation into a verified bundle of reference files. The only weakness is mild verbosity in step qualifiers and version-pinned details embedded in Error Handling rather than a dedicated compatibility section.

Suggestions

Move version-pinned compatibility details (e.g., 'In gh aw v0.58.3, engine.max-turns is not supported for Copilot, bash must be true, false, or an allowlist...') into a dedicated 'Version compatibility' or 'Deprecated/old patterns' section in a reference file so they don't age the main procedure.

Tighten hedged qualifiers in Steps 3–4 (e.g., 'unless the workflow intentionally uses checked-in files from that path', 'unless the task is explicitly a low-risk public workflow') into shorter exception clauses, cutting token cost without losing the guardrail.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational knowledge (trial host-repo secrets, './' path semantics, matrix concurrency cancellation) and explains nothing Claude already knows, but several step items carry wordy qualifiers that could be tightened ('unless the workflow intentionally uses checked-in files from that path'), and a version pin ('In `gh aw v0.58.3`, `engine.max-turns` is not supported for Copilot...') sits in Error Handling rather than a dedicated deprecated/old-patterns section, which the rubric flags as time-sensitive information penalizing conciseness. Solidly above the midpoint but not the 'every token earns its place' anchor.

4 / 5

Actionability

Concrete, executable commands appear throughout: 'gh aw fix --write', 'gh aw validate --strict', 'gh aw compile --verbose', 'gh aw run <workflow> --dry-run', 'gh aw trial ./.github/workflows/<workflow>.md', 'gh secret list -R <host-repo>', 'gh aw secrets bootstrap'. Specific gotchas (PAT vs gho_ token, delete_repo scope, './' path requirement) make the guidance copy-paste ready, matching the 5 anchor for an instruction-only skill.

5 / 5

Workflow Clarity

Six clearly sequenced steps (identify state → choose mode → author → configure prerequisites → validate/compile/execute → operate) with explicit validation checkpoints ('Run gh aw validate --strict before treating a workflow as ready', compile after validation, dry-run before direct execution) and an Error Handling section providing feedback loops for error recovery (fix frontmatter before continuing, inspect permissions inheritance before changing worker logic). Matches the 5 anchor's explicit validation plus error-recovery loops.

5 / 5

Progressive Disclosure

The body is a navigable overview with well-signaled, one-level-deep, conditionally-triggered references ('Read references/authoring.md before editing', 'Read references/examples.md when the task needs a starting pattern', 'Read references/troubleshooting.md when the workflow fails to compile'), and every referenced path (references/authoring.md, examples.md, security-and-operations.md, troubleshooting.md, scripts/find-gh-aw-targets.mjs, assets/workflow.template.md) exists in the actual bundle. Deep operational detail is correctly deferred to the reference files.

5 / 5

Total

19

/

20

Passed

Description

100%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.

An exemplary description: concrete verb-led capabilities, comprehensive domain enumeration, explicit use/don't-use triggers, and clean disambiguation from adjacent GitHub Actions tooling. All four dimensions sit squarely on the 5 anchors with no fluff or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ('Authors, reviews, installs, and debugs') and comprehensively enumerates the domain scope ('workflow markdown, frontmatter, gh aw compile and run flows, safe outputs, security guardrails, and operational patterns'). This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); nothing in the domain scope is missing.

5 / 5

Completeness

It explicitly answers 'what' ('Authors, reviews, installs, and debugs GitHub Agentic Workflows in repositories...'), 'when' ('Use when creating or maintaining GH-AW automation'), and even 'when not' ('Don't use for standard deterministic GitHub Actions YAML...'). This exceeds the 5 anchor, which only requires explicit what and when with concrete triggers.

5 / 5

Trigger Term Quality

Natural trigger terms cover the full product vocabulary users would actually say: 'GitHub Agentic Workflows', 'GH-AW automation', 'gh aw', 'GitHub Actions YAML', and 'CI pipelines' (the latter two as negative triggers). Full name, abbreviation, and CLI command forms are all present, matching the 5 anchor's comprehensive-synonyms criterion.

5 / 5

Distinctiveness Conflict Risk

A clear niche (GitHub Agentic Workflows) with explicit negative triggers that disambiguate it from the nearest overlapping skills: 'standard deterministic GitHub Actions YAML, generic CI pipelines, or non-GitHub automation systems'. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Reviewed

Table of Contents

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.