Skip to content
Skills Library
DevOps & cloud · Automation

managing-github-ci

/managing-github-ci

Configures GitHub Actions workflows and CI/CD pipelines. Use when creating workflow YAML, managing npm releases, troubleshooting CI failures, configuring Husky hooks, or setting up release automation. Do NOT use for local development commands or application code.

Licence
BSD-3-Clause
Last repository change
17.08.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 17.08.2026, without references to retired models or APIs.

Licence

BSD-3-Clause, otwarta.

What it does and when to use it

Configures GitHub Actions workflows and CI/CD pipelines. Use when creating workflow YAML, managing npm releases, troubleshooting CI failures, configuring Husky hooks, or setting up release automation. Do NOT use for local development commands or application code.

Original author description

Configures GitHub Actions workflows and CI/CD pipelines. Use when creating workflow YAML, managing npm releases, troubleshooting CI failures, configuring Husky hooks, or setting up release automation. Do NOT use for local development commands or application code.

How it works

  1. Overview
  2. When to Use
  3. Quick Reference
  4. Project CI Architecture
  5. Workflows
  6. Pre-Push Hooks (Husky)
  7. Changesets Configuration
  8. GitHub CLI
  9. Troubleshooting CI Failures
  10. Secrets Management
Original SKILL.md headings · 152 lines, 635 words
SKILL.md preview
---
name: managing-github-ci
description: "Configures GitHub Actions workflows and CI/CD pipelines. Use when creating workflow YAML, managing npm releases, troubleshooting CI failures, configuring Husky hooks, or setting up release automation. Do NOT use for local development commands or application code."
allowed-tools: "Read, Grep, Glob, Write, Edit, Bash(gh:*)"
metadata:
  author: Ollie Shop
  version: 1.0.0
compatibility: "Claude Code with Node.js >=20, pnpm, TypeScript 5.5+"
---

# GitHub CI Automation

## Overview

Guide the configuration and management of GitHub Actions workflows, release automation, and CI/CD pipelines for the Saleor Configurator project.

## When to Use

- Creating or modifying GitHub Actions workflows
- Setting up automated releases via Changesets
- Troubleshooting CI failures
- Configuring pre-commit/pre-push hooks (Husky)

## Quick Reference

| Workflow | Trigger | Purpose |
|----------|---------|---------|
| `test-on-pr.yml` | PR to main | Typecheck, lint, test, build |
| `release.yml` | Push to main | Changesets publish to npm |
| `changeset-bot.yml` | PR opened/synced | Comment on missing changesets |

## Project CI Architecture

```
.github/
├── workflows/
│   ├── test-on-pr.yml      # PR validation
│   ├── release.yml         # Automated releases
│   └── changeset-bot.yml   # Changeset automation

.husky/
├── pre-push               # Schema docs generation

.changeset/
├── config.json            # Changeset configuration
└── *.md                   # Pending changesets
```

## Workflows

### test-on-pr.yml

Validates PRs before merge. Runs: typecheck, lint, test, build. Uses pnpm 9 + Node 20.

See [references/workflow-templates.md](references/workflow-templates.md) for full YAML.

### Required Checks

| Check | Command | Purpose |
|-------|---------|---------|
| Type check | `pnpm typecheck` | TypeScript validation |
| Lint | `pnpm lint` | Biome linting |
| Test | `pnpm test` | Vitest test suite |
| Build | `pnpm build` | Compilation check |

### release.yml

Automated npm releases via Changesets. Triggers on push to main with concurrency control.

Uses `changesets/action@v1` with `pnpm publish:ci-prod`. Requires `GITHUB_TOKEN` and `NPM_TOKEN`.

### Release Flow

```
1. Developer creates changeset -> pnpm changeset
2. PR merged to main
3. Changesets action runs:
   a. If changesets exist -> Creates "Version Packages" PR
   b. If version PR merged -> Publishes to npm
```

### changeset-bot.yml

Comments on PRs about missing changesets. Uses `changesets/bot@v1`.

## Pre-Push Hooks (Husky)

Located in `.husky/pre-push`:
- Runs `pnpm generate-schema-docs` before every push
- Auto-commits schema documentation updates
- Ensures docs stay in sync with schema changes

## Changesets Configuration

Located in `.changeset/config.json`. Key settings: `access: "public"`, `baseBranch: "main"`.

| Type | When to Use |
|------|-------------|
| `patch` | Bug fixes, documentation, refactoring |
| `minor` | New features, non-breaking enhancements |
| `major` | Breaking changes, API modifications |

## GitHub CLI

Use `gh` for workflow management: `gh run list`, `gh run view <id>`, `gh run watch <id>`, `gh run rerun <id>`, `gh pr checks <number>`.

## Troubleshooting CI Failures

### Reproduce Locally

| Failure | Command |
|---------|---------|
| Type check | `pnpm typecheck` or `npx tsc --noEmit` |
| Lint | `pnpm lint` then `pnpm check:fix` |
| Tests | `pnpm test -- --filter=<file>` |
| Build | `pnpm build` |

### Debugging Steps

1. Check workflow logs in GitHub Actions UI
2. Reproduce failure locally with commands above
3. Fix the issue
4. Push fix to PR
5. Re-run failed jobs: `gh run rerun <run-id>`

### npm Publish Rate Limiting

If npm publish fails: wait and retry. Check status at https://status.npmjs.org/

## Secrets Management

| Secret | Purpose | Where Set |
|--------|---------|-----------|
| `GITHUB_TOKEN` | Auto-provided | GitHub |
| `NPM_TOKEN` | npm publishing | Repository Settings > Secrets > Actions |

## Common Mistakes

| Mistake | Fix |
|---------|-----|
| Missing `--frozen-lockfile` | Always use in CI installs |
| Using `@latest` action versions | Pin to specific versions (`@v4`) |
| No `concurrency` setting | Add to prevent duplicate runs |
| Forgetting to add changeset | Run `pnpm changeset` before PR |

## References

### Skill Reference Files
- **[Workflow Templates](references/workflow-templates.md)** - Full YAML workflow definitions and reusable patterns
- **[Troubleshooting Guide](references/troubleshooting.md)** - Detailed debugging patterns

### Project Resources
- `.github/workflows/` - Workflow files
- `.husky/` - Git hooks
- `.changeset/` - Changeset configuration

## Related Skills

- **Creating releases**: See `creating-changesets` for changeset creation
- **Local validation**: See `validating-pre-commit` for reproducing CI checks locally
Files in this package (3)
  • SKILL.md 5 KB
  • references/troubleshooting.md 6 KB
  • references/workflow-templates.md 8 KB

Versions

The database has no other skills named managing-github-ci.

Database snapshot: 13.11.2026 · package version 953bf2e2c053 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100project-automation
    4-layer project automation system - Husky pre-commit, GitHub Actions CI/CD, n8n monitoring, check scripts. Use when setting up project automation, configuring pre-commit hooks, establishing CI/CD pipelines, or adding quality checks.
  • 100github-workflow-automation
    Automate GitHub Actions workflows and CI/CD pipelines with claude-flow swarm coordination. Use when creating, optimizing, or debugging GitHub Actions workflow YAML, CI/CD pipelines, or GitHub repository automation — not for PR code review, releases, issues, or multi-repo sync…
  • 100workflows
    Write and optimize GitHub Actions workflows. Use when creating CI/CD pipelines, configuring workflow triggers, managing artifacts, or debugging workflow runs.
  • 100workflow-automation
    Automate repetitive development tasks and workflows. Use when creating build scripts, automating deployments, or setting up development workflows. Handles npm scripts, Makefile, GitHub Actions workflows, and task automation.
  • 100npm-release
    Use when setting up or running releases of an npm package from GitHub Actions with release-please and npm trusted publishing (no npm token, provenance, a release pull request), or when diagnosing a release that failed or a version that did not appear on npm.
  • 100github-actions
    GitHub Actions workflow generator — CI/CD pipelines, releases, Docker builds, reusable workflows, composite actions, dependabot. Use for .github/workflows/ generation, debugging, and security hardening.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.