secure-github-actions
Installation
SKILL.md
Secure GitHub Actions
Create, review, and audit GitHub Actions workflows with supply-chain-safe defaults.
CRITICAL RULES
- Read the relevant reference files first. When the user's request involves any topic in the reference table below, read those files before doing anything else. Briefly mention which files you are reading so the user can confirm the skill is active.
- Pin every non-local
uses:reference to a full 40-character commit SHA. Treat@v*,@main,@master, branch names, and short SHAs as security debt. - Never invent SHAs. Resolve them from GitHub or ask the user; if you cannot verify the right SHA, say so explicitly instead of fabricating one.
- Do not introduce
pull_request_targetunless the user explicitly requires it and the workflow never executes untrusted code with secrets or write permissions. - Never splice untrusted context directly into shell. Move
${{ github.* }},${{ inputs.* }}, and similar values intoenv:and quote the shell variable. - Set explicit least-privilege
permissions:. Default to read-only and grant write scopes only to the specific job that needs them. - Always run the full audit checklist when asked to "audit", "harden", or "security scan" a repository.
- Never silently skip a check. If a tool is missing (gitleaks, trufflehog, zizmor), report it and suggest installation.
- After compaction or context loss, re-read this SKILL and the reference files before continuing.