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.
- Author
- saleor ↗
- Repository
- configurator ↗
- Licence
- BSD-3-Clause
- Last repository change
- 17.08.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 17.08.2026, without references to retired models or APIs.
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
- Overview
- When to Use
- Quick Reference
- Project CI Architecture
- Workflows
- Pre-Push Hooks (Husky)
- Changesets Configuration
- GitHub CLI
- Troubleshooting CI Failures
- Secrets Management
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.