К основному содержанию
скилл CX Codex

github-actions · oakoss — скилл для Claude Code: настройка CI/CD

Скилл для Claude Code помогает создавать и настраивать GitHub Actions workflows: от триггеров и матриц сборки до кеширования и аутентификации. Автоматизирует тесты, релизы и развёртывание.

MIT 149 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill github-actions -a claude-code
Открыть на GitHub

Что делает github-actions

Скилл помогает описывать workflows в YAML для сборки, тестирования и развёртывания через GitHub Actions. Он охватывает триггеры событий, зависимости между jobs, шаги, матричные сборки, кеши и артефакты. Есть темы для повторно используемых workflows, составных actions и передачи данных между шагами.

Также скилл разбирает секреты, OIDC-аутентификацию и настройку permissions. Среди типичных ошибок — широкие права на уровне всего workflow и запуск кода из pull request с правами на запись. Для долгих задач есть ограничение: GitHub Actions останавливает job после шести часов.

Какие задачи решает

  • создать workflow для сборки и тестирования при push
  • настроить матричный запуск для нескольких версий среды
  • добавить кеш зависимостей и передачу артефактов между jobs
  • собрать повторно используемый workflow или составной action
  • ограничить permissions и настроить OIDC для облачной аутентификации

Примеры запросов агенту

  • Создай workflow GitHub Actions для тестов при каждом pull request.
  • Настрой матрицу сборки для версий Node.js 18, 20 и 22.
  • Проверь permissions и кеш зависимостей в моём workflow.

Как установить github-actions

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill github-actions -a claude-code

2Вручную: положить файлы

~/.claude/skills/github-actions/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/github-actions/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о github-actions

Как установить github-actions в Claude Code?

Выполните npx skills add oakoss/agent-skills --skill github-actions -a claude-code. Файл скилла находится по пути ~/.claude/skills/github-actions/SKILL.md.

Что делает скилл github-actions?

Он помогает создавать и настраивать GitHub Actions workflows для CI/CD: описывать jobs и триггеры, кешировать зависимости, передавать артефакты и задавать права.

Как скилл помогает ограничить права в GitHub Actions?

Он рекомендует задавать пустые permissions на уровне workflow и выдавать нужные права отдельным jobs. Для OIDC используется разрешение id-token: write.

Исходный текст

SKILL.md · MIT
---
name: github-actions
description: >
  GitHub Actions workflow authoring for CI/CD pipelines. Covers workflow syntax,
  triggers, jobs, steps, matrix strategies, caching, artifacts, reusable workflows,
  composite actions, secrets management, OIDC authentication, and permissions hardening.

  Use when creating workflows, configuring jobs, setting up caching, or automating releases.
  Use for github-actions, workflow, ci, cd, actions, jobs, steps, matrix, cache, artifact,
  secrets, reusable-workflow.
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://docs.github.com/en/actions'
user-invocable: false
---

# GitHub Actions

## Overview

GitHub Actions is a CI/CD platform that automates build, test, and deployment pipelines directly from GitHub repositories. Workflows are YAML files in `.github/workflows/` triggered by events like pushes, pull requests, schedules, or manual dispatch. Each workflow contains one or more jobs that run on GitHub-hosted or self-hosted runners.

**When to use:** Automated testing, continuous deployment, release automation, scheduled tasks, multi-platform builds, dependency updates, container publishing, code quality checks, security scanning.

**When NOT to use:** Long-running services (use a proper hosting platform), heavy compute tasks exceeding runner limits (6-hour job timeout), tasks requiring persistent state between runs (use external storage), real-time event processing (use webhooks with a server).

## Quick Reference

| Pattern             | Syntax / Action                                  | Key Points                                  |
| ------------------- | ------------------------------------------------ | ------------------------------------------- |
| Push trigger        | `on: push: branches: [main]`                     | Filter by branch, path, or tag              |
| PR trigger          | `on: pull_request: types: [opened, synchronize]` | Defaults to opened, synchronize, reopened   |
| Scheduled trigger   | `on: schedule: - cron: '0 6 * * 1'`              | UTC only, minimum 5-minute interval         |
| Manual trigger      | `on: workflow_dispatch: inputs:`                 | Define typed inputs for manual runs         |
| Job dependencies    | `needs: [build, test]`                           | Run jobs in sequence or parallel            |
| Conditional job     | `if: github.ref == 'refs/heads/main'`            | Expression-based job/step filtering         |
| Matrix strategy     | `strategy: matrix: node: [18, 20, 22]`           | Generates jobs for each combination         |
| Dependency cache    | `actions/cache@v5`                               | Hash-based keys with restore-keys fallback  |
| Setup with cache    | `actions/setup-node@v6` with `cache: 'pnpm'`     | Built-in caching for package managers       |
| Upload artifact     | `actions/upload-artifact@v4`                     | Share data between jobs or preserve outputs |
| Download artifact   | `actions/download-artifact@v4`                   | Retrieve artifacts from earlier jobs        |
| Reusable workflow   | `uses: ./.github/workflows/reusable.yml`         | Called with `workflow_call` trigger         |
| Composite action    | `action.yml` with `using: composite`             | Bundle multiple steps into one action       |
| Concurrency         | `concurrency: group: ${{ github.ref }}`          | Cancel or queue duplicate runs              |
| Environment secrets | `${{ secrets.API_KEY }}`                         | Scoped to repo, org, or environment         |
| OIDC authentication | `permissions: id-token: write`                   | Short-lived tokens for cloud providers      |
| Step outputs        | `echo "key=value" >> "$GITHUB_OUTPUT"`           | Pass data between steps and jobs            |
| Service containers  | `services: postgres: image: postgres:16`         | Sidecar containers for integration tests    |
| Timeout             | `timeout-minutes: 30`                            | Fail fast on hung jobs or steps             |
| Attestations        | `actions/attest-build-provenance@v3`             | SLSA build provenance for supply chain      |

## Expressions and Contexts

| Context   | Example                         | Description                               |
| --------- | ------------------------------- | ----------------------------------------- |
| `github`  | `github.ref_name`, `github.sha` | Event metadata, repo info, actor          |
| `env`     | `env.NODE_ENV`                  | Environment variables at current scope    |
| `secrets` | `secrets.API_KEY`               | Encrypted secrets (masked in logs)        |
| `inputs`  | `inputs.environment`            | Workflow dispatch or reusable inputs      |
| `matrix`  | `matrix.node`                   | Current matrix combination values         |
| `steps`   | `steps.build.outputs.version`   | Outputs from previous steps               |
| `needs`   | `needs.prepare.outputs.tag`     | Outputs from dependent jobs               |
| `runner`  | `runner.os`, `runner.arch`      | Runner environment info                   |
| `vars`    | `vars.DEPLOY_URL`               | Repository or org configuration variables |

## Common Mistakes

| Mistake                                      | Correct Pattern                                                            |
| -------------------------------------------- | -------------------------------------------------------------------------- |
| Using outdated action major versions         | Pin to current major version (`@v6`) or commit SHA                         |
| Missing `persist-credentials: false`         | Set on checkout when using custom tokens or OIDC                           |
| Broad `permissions` at workflow level        | Set `permissions: {}` at workflow level, grant per-job                     |
| Cache key without dependency file hash       | Include `hashFiles('**/pnpm-lock.yaml')` in cache key                      |
| Secrets in `if:` conditions                  | Secrets cannot be used in `if:` expressions directly                       |
| Using `pull_request_target` carelessly       | Never run PR code with write permissions from `pull_request_target`        |
| Not cancelling stale runs                    | Use `concurrency` with `cancel-in-progress: true`                          |
| Storing structured data as a single secret   | Create individual secrets per value for proper log redaction               |
| Referencing action tags without SHA pinning  | Pin third-party actions to full commit SHA for supply chain safety         |
| Hardcoding runner OS in scripts              | Use `runner.os` context for cross-platform compatibility                   |
| Using `actions/cache` without `restore-keys` | Always provide restore-keys for partial cache matches                      |
| Interpolating user input in `run:` blocks    | Pass untrusted values through `env:` to prevent script injection           |
| No `timeout-minutes` on jobs                 | Set explicit timeouts to fail fast on hung processes                       |
| Using `always()` without scoping             | Combine with status checks: `if: always() && steps.x.outcome == 'success'` |

## Delegation

- **Workflow debugging**: Use `Explore` agent to inspect workflow run logs
- **Security auditing**: Use `Task` agent to review permissions and secret usage
- **Code review**: Delegate to `code-reviewer` agent for workflow PR reviews

## References

- [Workflow syntax, triggers, jobs, steps, and concurrency](references/workflow-syntax.md)
- [Caching strategies and artifact management](references/caching-and-artifacts.md)
- [Matrix strategies, reusable workflows, and composite actions](references/matrix-and-reusable.md)
- [Security, secrets, OIDC, and permissions hardening](references/security-and-secrets.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →

Сначала — github-actions от других авторов.

github-actions callstackincubator Готовые шаблоны GitHub Actions для сборки React Native приложений на iOS-симуляторе и Android-эмуляторе в облаке с загрузкой артефактов. Упрощает настройку CI-пайплайнов и скачивание собранных бинарников через gh или REST API. CX Codex +1 12 400установок github-actions devops-skills Скилл помогает агенту писать и править workflow-файлы GitHub Actions: сборка, тесты, деплой, секреты, кэш и self-hosted раннеры. CX Codex +1 429установок github-actions bobmatnyc Скилл github-actions для Claude Code помогает настраивать GitHub Actions для сборки, тестирования и деплоя. Запускайте проверки на pull request или автоматизируйте выпуск приложения. CX Codex +1 778установок github-actions tartinerlabs Создаёт и проверяет воркфлоу GitHub Actions: пинит экшены по SHA, чинит permissions и находит устаревшие версии Node. CX Codex +1 446установок github-actions tddworks Управляет GitHub Actions сборки, тестов и релизов ClaudeBar. Настраивает секреты и теги, запускает workflow вручную и помогает разбирать сбои. CX Codex +1 ★ 1 586звёзд репо GitHub Actions Expert официальный github Субагент GitHub Actions Expert для GitHub Copilot, который пишет и проверяет CI/CD-воркфлоу с упором на безопасность цепочки поставок. Закрепляет экшены по SHA и убирает долгоживущие ключи. CX Codex +1 ★ 41 430звёзд репо github-actions-expert carlrannaberg Субагент github-actions-expert помогает настраивать и защищать пайплайны GitHub Actions. Пригодится при медленной сборке или ошибках в синтаксисе YAML. CX Codex ★ 763звёзд репо github-actions-generator akin-ozer Скилл github-actions-generator для Claude Code генерирует рабочие процессы GitHub Actions, кастомные экшены и переиспользуемые пайплайны. Собирает .github/workflows без ручного перебора версий экшенов по дереву решений. CX Codex +1 714установок github-actions-2025 JosiahSiegel Скилл github-actions-2025 помогает настроить пайплайны с новыми возможностями GitHub Actions: раннерами на 1 vCPU, неизменяемыми релизами и переходом на Node24. CX Codex +1 166установок github-actions-ci-cd-best-practices официальный github Правило github-actions-ci-cd-best-practices для GitHub Copilot: подсказывает структуру workflow, работу с секретами, кэшем и матрицами при правке файлов в .github/workflows/. CX Codex +1 ★ 41 430звёзд репо github-actions-templates Seth Hobson Скилл github-actions-templates для Claude Code создаёт GitHub Actions для тестирования, сборки и деплоя. Настраивает CI/CD и reusable workflows. CX Codex +1 17 420установок

Из того же набора106

Весь набор →
opentofu Помогает писать и проверять конфигурации OpenTofu и Pulumi. Помогает управлять инфраструктурой, состоянием и окружениями из кода. CX Codex +1 153установок arktype-validation Скилл arktype-validation для Claude Code описывает схемы ArkType строками в синтаксисе TypeScript, включая морфы и рантайм-валидацию данных и переменных окружения через ArkEnv. CX Codex +1 153установок tanstack-router Скилл tanstack-router настраивает типобезопасную файловую маршрутизацию в React через @tanstack/react-router. Помогает с лоадерами данных, валидацией параметров поиска и разделением кода. CX Codex +1 150установок api-testing Скилл api-testing для Claude Code помогает писать интеграционные тесты REST API и проверять ответы эндпоинтов. Включается при настройке HTTP-моков или тестировании ошибок. CX Codex +1 149установок git-workflow Скилл git-workflow помогает агенту выстраивать trunk-based разработку, оформлять conventional commits, настраивать пайплайны GitHub Actions и чистить историю Git. CX Codex +1 149установок ux-designer Скилл ux-designer для ИИ-агентов: проводит проект от информационной архитектуры до передачи в разработку, с проверкой доступности и юзабилити. CX Codex +1 148установок responsive-images Скилл responsive-images внедряет адаптивные изображения с srcset, современными форматами AVIF и WebP, защищая от сдвигов верстки CLS и ускоряя LCP. CX Codex +1 148установок tanstack-virtual Скилл учит агента виртуализировать длинные списки, таблицы и сетки на TanStack Virtual: в DOM остаются только видимые строки. CX Codex +1 148установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой