SkillsAdd

smithery/saleor

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.

Installation

$ npx skills add smithery/saleor --skill managing-github-ci
View on skills.sh ↗ Website ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

find-skills Same topic
vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…

3.3M installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-prepare Same topic
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

568.3K installs

Also in this package

Other skills from smithery/saleor · top by installs.

npx skills add smithery/saleor
writing-graphql-operations 0 validating-pre-commit 0 understanding-saleor-domain 0 saleor-domain 0 reviewing-typescript-code 0 product-modeling 0 implementing-cli-patterns 0 designing-zod-schemas 0 creating-changesets 0 configurator-schema 0

Browse all from smithery/saleor

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.0.0
CompatibilityClaude Code with Node.js >=20, pnpm, TypeScript 5.5+
Allowed toolsRead, Grep, Glob, Write, Edit, Bash(gh:*)
Declared agents claude-code
More metadata
author
Ollie Shop
version
1.0.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,926 B
  • docs SUMMARY.md 295 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

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 GITHUBTOKEN and NPMTOKEN.

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