CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

github-actions

Design, review, secure, and debug GitHub Actions workflows — reusable workflows, OIDC federation, SHA pinning, token scoping, promotion orchestration, and CI failure diagnosis.

Quality

81%

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

85%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 body is exceptionally actionable — concrete commands, pinned-SHA YAML, error-triage flows, and validation tooling — with tight, low-padding prose. Its one real structural defect is that it depends on progressive disclosure that does not exist: references/github-actions.md and examples/github-actions/* are cited multiple times but absent from the bundle, and 'Common mistakes' duplicates the review-mode checklist.

Suggestions

Create the referenced bundle files (references/github-actions.md and examples/github-actions/{terraform-cicd.yml,container-build.yml,reusable-workflows/}) or remove the 'Read references/github-actions.md before responding' instructions and example citations so no path dangles.

Deduplicate 'Common mistakes' against the review-mode CRITICAL/WARNING lists — either drop the duplicated entries (pull_request_target, mutable tags, OIDC environment) or fold them into the review checklist and keep 'Common mistakes' for items the checklist does not cover (e.g., workflow_dispatch input validation).

Compress the Interactive Wizard section to a short table of mode → follow-up question instead of verbatim prompt scripts, keeping the same information in roughly half the tokens.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no padding explaining what GitHub Actions is; it is composed of tables, checklists, and code. Minor trimmable redundancy: 'Common mistakes' restates review-mode CRITICAL items almost verbatim ('pull_request_target + PR head checkout', 'Mutable action tags', OIDC environment mismatch), and the verbatim wizard scripts add length without much guidance value. Not 5 because these duplications mean a few tokens do not earn their place.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: exact SHA-resolution commands ('gh api repos/{owner}/{repo}/git/refs/tags/{tag} --jq '.object.sha''), validation commands ('actionlint .github/workflows/<workflow>.yml', 'zizmor --strict-collection'), complete YAML with pinned SHAs and comments, IAM trust-policy JSON, per-job permission tables, and an OIDC token-decode debug snippet. Specific examples cover the common design, security, review, and debug cases.

5 / 5

Workflow Clarity

Each mode is clearly sequenced: design uses Steps 1–4 (classify → job pattern → structure → promotion); debug instructs 'Identify the failure layer first' with a 6-layer triage, then diagnosis-by-error-type, then explicit validation commands (actionlint/zizmor/gh run view --log-failed) forming a fix-and-recheck feedback loop; review is a severity-ranked checklist with a structured report format. These are exactly the checklist-plus-feedback-loop patterns the top anchor describes.

5 / 5

Progressive Disclosure

References are clearly signaled ('Read references/github-actions.md before responding', a '## Reference' section, example paths under examples/github-actions/), but the bundle contains no references/, examples/, scripts/, or assets/ directories — every referenced path is dangling, so a reader following the instruction hits a dead end. Per the guideline to score against the actual bundle structure, clearly-signaled but nonexistent references plus a ~370-line body inlining all detail sits between 'references present but poorly organized' and 'appropriately split'.

3 / 5

Total

17

/

20

Passed

Description

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

A strong, specific description that names concrete actions and a distinct GitHub Actions niche. Its single material weakness is the missing 'when' half: no 'Use when...' trigger clause, which caps completeness and slightly weakens trigger-term coverage (no synonyms or path forms like .github/workflows).

Suggestions

Append an explicit trigger clause, e.g.: 'Use when the user mentions GitHub Actions, .github/workflows files, CI/CD pipelines, action pinning, OIDC, or a failing workflow run.' This removes the completeness cap at 3.

Add natural synonyms and path forms users actually say — '.github/workflows', 'Actions workflow', 'CI pipeline', 'workflow YAML' — to lift trigger-term coverage toward the top anchor.

Sharpen the boundary with sibling skills (e.g., route fine-grained composite-action scaffolding and zizmor audit-catalogue requests away from this description) to reduce the remaining overlap with the zizmor and composite-actions skills.

DimensionReasoningScore

Specificity

'Design, review, secure, and debug GitHub Actions workflows' lists four concrete actions, and the subtopic list ('reusable workflows, OIDC federation, SHA pinning, token scoping, promotion orchestration, and CI failure diagnosis') covers the domain comprehensively — multiple specific concrete actions with no notable gaps. Anchor 4 ('minor gaps in coverage') fits worse since the enumeration is broader than the anchor-5 example's four actions.

5 / 5

Completeness

The 'what' is explicit and concrete (design/review/secure/debug plus the six subtopics), but there is no 'Use when...' clause or any equivalent explicit trigger guidance — the judging guideline caps completeness at 3 in that case. It is a solid 3 rather than lower because the 'what' half is unusually clear and specific.

3 / 5

Trigger Term Quality

Good natural keywords users would say: 'GitHub Actions', 'workflows', 'CI failure'. A few natural terms and synonyms are missing: no file-extension or path forms ('.github/workflows', '.yml'), no 'pipeline' or 'CI/CD' phrasing. Not 5 because the top anchor expects synonyms and extensions; not 3 because coverage goes well beyond a bare domain mention.

4 / 5

Distinctiveness Conflict Risk

'GitHub Actions workflows' with OIDC federation and SHA pinning is a clear, distinct niche unlikely to fire for unrelated skills. Minor overlap remains with closely related sibling skills: 'review'/'secure' of workflows overlaps the zizmor security-audit skill and composite-actions covers the adjacent reusable-step territory, so it is mostly distinct rather than minimal-conflict (anchor 5).

4 / 5

Total

16

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

nitinjain999/platform-skills

Path

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