astro-github-actions
Sets up GitHub Actions CI/CD workflows for Astro sites — `astro check` (TypeScript + content schema), ESLint, Prettier, build verification, Vitest testing, Lighthouse CI, link checking, npm audit, and automated deployment to GitHub Pages, Cloudflare Pages, Netlify, or Vercel. ALWAYS use this skill when a user wants to create, add, set up, or configure GitHub Actions, CI/CD, automated checks, or deployment workflows for an Astro site — even if they don't use the exact phrase "GitHub Actions". This includes any request to: add automated type-checking or linting to an Astro repo; set up `astro check` in CI; add Lighthouse or accessibility checks to PRs; configure Vitest in CI for an Astro project; auto-deploy an Astro site to GitHub Pages, Cloudflare Pages, Netlify, or Vercel from GitHub; add link checking or broken-link detection; add security scanning to an Astro pipeline; or generally "add CI", "add automated checks", "set up workflows", or "automate" anything related to an Astro site'
jdevalk · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add jdevalk/skills --skill astro-github-actionsAbout this skill
name: astro-github-actions
description: |
Sets up GitHub Actions CI/CD workflows for Astro sites — astro check (TypeScript + content schema), ESLint, Prettier, build verification, Vitest testing, Lighthouse CI, link checking, npm audit, and automated deployment to GitHub Pages, Cloudflare Pages, Netlify, or Vercel. ALWAYS use this skill when a user wants to create, add, set up, or configure GitHub Actions, CI/CD, automated checks, or deployment workflows for an Astro site — even if they don't use the exact phrase "GitHub Actions". This includes any request to: add automated type-checking or linting to an Astro repo; set up astro check in CI; add Lighthouse or accessibility checks to PRs; configure Vitest in CI for an Astro project; auto-deploy an Astro site to GitHub Pages, Cloudflare Pages, Netlify, or Vercel from GitHub; add link checking or broken-link detection; add security scanning to an Astro pipeline; or generally "add CI", "add automated checks", "set up workflows", or "automate" anything related to an Astro site's GitHub repository. Also trigger when someone wants quality gates on PRs, wants to verify the build still passes, or is setting up a new Astro repo and wants best practices for automation. If the user is inside an Astro project repository and mentions anything about automated testing, code quality, deployment, or GitHub workflows, use this skill.
Astro GitHub Actions
This skill helps you set up a comprehensive CI/CD pipeline for Astro sites using GitHub Actions. The goal is to help authors ship higher-quality sites with less manual effort: type errors caught before merge, broken links flagged, builds verified, and deploys automated.
What this skill covers
There are several categories of workflows that a healthy Astro project should have. Not every site needs all of them — the right mix depends on whether the project has TypeScript, custom components, content collections, tests, and where it deploys. Your job is to figure out which ones are relevant and set them up.
The workflows fall into these categories:
- Type/content checking —
astro check(TypeScript + content collection schema validation) - Code quality — ESLint and Prettier
- Build verification —
astro buildruns cleanly - Testing — Vitest for unit and component tests
- Quality gates — Lighthouse CI (performance, a11y, SEO, best practices)
- Link checking — broken-link detection on the built site
- Security — npm audit for dependency vulnerabilities
- Deployment — GitHub Pages, Cloudflare Pages, Netlify, or Vercel
Read references/workflows.md for the detailed configuration of each workflow, including ready-to-use YAML templates and configuration files.
How to approach a request
Step 1: Understand the project
Before writing any workflow files, figure out what you're working with:
- Is it TypeScript? Check for
tsconfig.jsonand.ts/.astrofiles. Almost every Astro project should runastro check, but the value is highest when there's TypeScript in.astrofrontmatter, content collection schemas, orsrc/. - Does it use content collections? Check for
src/content/config.tsorsrc/content.config.ts. If yes,astro checkvalidates the schemas — extra valuable. - Does it have tests? Check for
tests/,__tests__/,*.test.ts, orvitest.config.ts. If yes, set up the Vitest workflow. If not, mention that adding tests would be valuable but don't force it. - What's the package manager? Look for
pnpm-lock.yaml,yarn.lock, orpackage-lock.json. Match the workflow's install command (pnpm i --frozen-lockfile,yarn install --frozen-lockfile, ornpm ci). - Where does it deploy? Look for a
wrangler.toml(Cloudflare),netlify.toml(Netlify),vercel.json(Vercel), or just ask. Most hosts have their own GitHub app that auto-deploys without Actions — only set up a deploy workflow if the user actually wants Actions to handle it (typically GitHub Pages or self-hosted). - Does it have a build step? Astro always does (
astro build) — but verify the script inpackage.jsonis the standardastro buildand not something custom. - Is it SSR or static? Check
astro.config.*for anoutput: 'server'or an adapter import. SSR projects deploy differently (Cloudflare/Netlify/Vercel adapters) and may not be deployable to GitHub Pages at all.
Step 2: Recommend a set of workflows
Based on what you found, recommend which workflows to set up. A good default for most Astro sites:
astro check(almost always — this is the most valuable check for Astro)- Build verification (almost always — catches integration regressions
astro checkcan miss) - ESLint + Prettier (if config files exist or the user wants them)
- Lighthouse CI (great for content sites with public URLs)
- Link checker (great for content-heavy sites)
- npm audit (cheap, almost always worth it)
And conditionally:
- Vitest tests (if tests exist)
- Deploy workflow (only if the user wants Actions-driven deploys — most Astro hosts use their own GitHub app)
Step 3: Create the workflow files
Create each workflow as a separate YAML file in .github/workflows/. Using separate files rather than one monolithic workflow gives clearer feedback in PRs (each check shows independently) and makes it easier to enable/disable individual checks.
Use the templates from references/workflows.md as starting points, but adapt them to the specific project. Common adaptations include adjusting the package manager, the Node version, the build artifact path, and the deploy target.
Step 4: Create supporting config files
Depending on which workflows you set up, you may also need:
eslint.config.js— ESLint flat config witheslint-plugin-astro.prettierrcand.prettierignore— Prettier config withprettier-plugin-astrolighthouserc.json— Lighthouse CI assertionslychee.toml— link checker config (if using lychee)- `vit