Skip to content

docs: add integration guide for combining skill with git hooks and CI tools #91

@q-soriarty

Description

@q-soriarty

Problem

The skill relies on Claude Code's LLM interpretation to enforce workflow rules. Teams that want mechanical enforcement alongside the skill have no guidance on how to set up:

  • Pre-commit hooks (e.g., husky, pre-commit) for commit message validation
  • commit-msg validators (e.g., commitlint) to enforce Conventional Commits format
  • Branch name linting to enforce the naming convention
  • CI/CD integration to validate PR titles match Conventional Commits

Expected behavior

Add an "Integration" section to SKILL.md (or a separate INTEGRATIONS.md linked from README) covering:

  1. Recommended tools for mechanical enforcement
  2. Example commitlint config that matches the skill's Conventional Commits rules
  3. Example husky/pre-commit setup
  4. How these tools complement (not replace) the skill

Keep it concise — config snippets and links to official docs, not full tutorials.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions