git-workflow-architect

Generates Git workflow configurations including commitlint, husky hooks, PR templates, and CI pipelines.

1|Updated Aug 25, 2026
One-click install
npx skills add https://github.com/sabiscore/swarmxq --skill git-workflow-architect-sabiscore
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow-architect
Source: https://github.com/sabiscore/swarmxq/tree/main/.ai/skills/git-workflow-architect
Command: npx skills add https://github.com/sabiscore/swarmxq --skill git-workflow-architect-sabiscore

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a consistent Git workflow involves many interdependent pieces — commit message linting, pre-commit hooks, PR templates, CI pipelines, and semantic release — with specific dependency ordering and hook setup steps that are easy to get wrong. This Skill generates all of these as complete, copyable configuration files. ## Core Features & Use Cases - Conventional Commits Setup: Generates commitlint, commitizen, husky, and lint-staged configurations with correct hook wiring. - CI/CD Pipelines: Produces GitHub Actions workflows for validation, build, commit linting, and semantic release. - Branch Strategy & Templates: Provides trunk-based or Gitflow branch strategies plus a structured GitHub PR template. - Use Case: A developer starting a new Next.js monorepo asks to set up conventional commits and CI; the Skill outputs commitlint.config.ts, .husky hooks, lint-staged config, ci.yml, and a PR template ready to commit. ## Quick Start Ask the AI to set up conventional commits with husky, commitlint, and a GitHub Actions CI pipeline for your Node.js project.

Frequently Asked Questions about git-workflow-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up conventional commits with commitlint and husky?

Install @commitlint/cli, @commitlint/config-conventional, commitizen, husky, and lint-staged as dev dependencies, then run husky init. Add a commit-msg hook that runs commitlint --edit and a pre-commit hook that runs lint-staged.

How to set up semantic release for automated versioning?

Install semantic-release with the changelog, git, and github plugins, then configure .releaserc.json with your release branches. Add a release job to your CI workflow that runs semantic-release on pushes to main with GITHUB_TOKEN.

What branch strategy should I use for my team?

Trunk-based development is recommended for teams shipping fast: a single main branch with short-lived feature branches merged via PR. Gitflow suits scheduled releases with develop, release, and hotfix branches.

Does commitlint work with pnpm and GitHub Actions?

Yes, commitlint runs via pnpm exec in both local husky hooks and CI. In GitHub Actions, use fetch-depth: 0 on checkout and run commitlint --from the PR base SHA --to HEAD to lint all PR commits.

Why is my commit rejected by commitlint?

Commitlint rejects messages that do not follow the conventional commit format, such as missing type prefixes like feat or fix, uppercase subjects, or lines exceeding configured length limits. Run pnpm commit to use the interactive commitizen prompt instead.