CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

github-actions-generator

Generates production-ready GitHub Actions workflows, custom actions, and CI/CD configurations following security and performance standards. Creates CI/CD pipelines, test workflows, deployment configurations, matrix builds, caching strategies, composite actions, Docker actions, JavaScript actions, and reusable workflows. Use when creating or scaffolding GHA resources, writing .github/workflows YAML files, setting up build automation, implementing deployment pipelines, adding security scanning, or building reusable actions — including triggers like 'create a workflow', 'build a pipeline', 'add CI', 'set up GHA', or 'generate a YAML workflow'.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

73%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, actionable skill body with executable YAML, real pinned SHAs, and a mandatory validate-fix-revalidate loop applied to every generated resource. Its weaknesses are redundancy (Workflow Summary and Mandatory Standards sections duplicate other content), one internal contradiction (fail-fast: false in Common Patterns vs. the anti-pattern requiring justification), and an undiscoverable assets/examples/ directory.

Suggestions

Delete the 'Workflow Summary' section (it restates the per-capability processes and Validation Workflow) and fold the 'Mandatory Standards' table into the Anti-Patterns section to remove duplication.

Fix the fail-fast contradiction: either remove 'fail-fast: false' from the Matrix Testing snippet in Common Patterns or add the explicit justification comment the anti-pattern requires.

Add an 'examples' row to the References table pointing to assets/examples/ so its 15 complete workflow and action examples are discoverable directly from SKILL.md.

DimensionReasoningScore

Conciseness

The body mostly assumes Claude's competence (no 'what is GitHub Actions' padding) and encodes genuinely non-obvious guidance, but three sections are redundant: 'Workflow Summary' restates the per-capability process steps, the 'Mandatory Standards' table restates the anti-patterns (SHA pinning, minimal permissions, caching/concurrency), and SHA-pinning guidance appears in the example, the standards table, and an anti-pattern. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 4's 'minor instances' — the duplication spans whole sections, not isolated lines.

3 / 5

Actionability

Guidance is concrete and mostly copy-paste ready: a fully executable minimal workflow with real pinned SHAs and version comments, permissions blocks, a reusable-workflow snippet, and BAD/GOOD pairs for each anti-pattern. However, the 'Common Patterns' matrix snippet uses 'fail-fast: false' with no justification, directly contradicting the 'NEVER set fail-fast: false by default' anti-pattern in the same file — an internal inconsistency that could mislead generation. That is a minor gap, matching anchor 4 ('mostly executable guidance... minor gaps') rather than anchor 5's fully consistent coverage.

4 / 5

Workflow Clarity

Every capability has a numbered process ending in an explicit validation step ('Validate with devops-skills:github-actions-validator'), and the Validation Workflow section defines the full feedback loop: generate → validate → 'If errors: fix and re-validate' → present, with explicit skip conditions. This matches the top anchor (clear sequence, explicit validation steps, feedback loops for error recovery) and exceeds anchor 4, whose 'minor validation gaps' are absent.

5 / 5

Progressive Disclosure

The body is well-structured with one-level-deep, clearly signaled references: a References table maps each of the six existing references/*.md files and five existing templates to a 'When to Use' scenario. However, assets/examples/ — 15 complete example workflows and actions — is never mentioned in SKILL.md and is only discoverable via a second-level hop through references/advanced-triggers.md, so part of the bundle is effectively orphaned. This matches anchor 4 ('good structure; references mostly clear; minor organization gaps') rather than anchor 5's fully navigable split.

4 / 5

Total

16

/

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 skill description: third-person voice, concrete and comprehensive capability enumeration, an explicit 'Use when...' clause with quoted natural trigger phrases including synonyms and file paths. The only nitpick is mild redundancy — workflows and actions are enumerated twice (first generally, then by type) — which costs a few tokens but does not reduce clarity.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: 'Generates production-ready GitHub Actions workflows, custom actions, and CI/CD configurations', 'Creates CI/CD pipelines, test workflows, deployment configurations, matrix builds, caching strategies, composite actions, Docker actions, JavaScript actions, and reusable workflows'. It matches the top anchor (multiple specific concrete actions, comprehensive) and exceeds anchor 4, whose 'minor gaps in coverage' do not apply here.

5 / 5

Completeness

It explicitly answers both questions: 'what' via the first two sentences ('Generates... Creates...') and 'when' via the explicit clause 'Use when creating or scaffolding GHA resources, writing .github/workflows YAML files... including triggers like [quoted phrases]'. This matches the top anchor exactly (clear what AND when with concrete trigger phrases), exceeding anchor 4 where 'when could be more specific'.

5 / 5

Trigger Term Quality

It covers natural terms including synonyms and file paths users would actually say: 'create a workflow', 'build a pipeline', 'add CI', 'set up GHA', 'generate a YAML workflow', 'writing .github/workflows YAML files', 'adding security scanning'. This matches the top anchor (comprehensive coverage including synonyms and file-path variants); anchor 4's 'a few natural terms missing' does not fit.

5 / 5

Distinctiveness Conflict Risk

The description is tightly scoped to GitHub Actions ('GitHub Actions workflows', 'GHA', '.github/workflows YAML'), with a clear niche and distinct generative triggers. Even though a sibling validator skill exists, every trigger verb is generative (creating, scaffolding, writing, setting up, building), so 'validate my workflow' would not match — minimal conflict risk, matching the top anchor rather than anchor 4's 'minor overlap risk'.

5 / 5

Total

20

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 5 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 11 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/ci-cd/github-actions/generator/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.