How this skill is triggered — by the user, by Claude, or both
Slash command
/xxthunder-dev-skills:commit-helperThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
---
Guide for creating conventional commits with mandatory pre-commit checks.
Before every commit, you MUST:
Run unit tests using the project's test execution skill
Run integration tests (using the project's test execution skill) when ANY of the following apply:
Verify linting (runs automatically via the project's test execution skill)
Never commit if:
<type>(<scope>): <subject>
<body>
<footer>
Must be one of:
Component affected (project-specific, e.g., api, auth, cli, test).
<type>(<scope>): <description> (<ISSUE-ID>)BREAKING CHANGE: descriptionCloses #123Co-Authored-By: Name <email>feat: add input validation function (<ISSUE-ID>)
Add validateInput() to check user-supplied values.
Returns false for null or empty strings.
Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
fix: handle names with spaces in lookup (<ISSUE-ID>)
Properly quote name parameter to support values containing spaces.
Closes #42
Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
refactor: consolidate error handling in utils (<ISSUE-ID>)
Extract common error handling pattern into helper function.
No behavior change.
Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
feat(api): add silent mode to command executor (<ISSUE-ID>)
- Suppresses console output when silent flag is used
- Useful for background operations
- Tests updated to verify behavior
Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
When AI assists with the code, add co-author:
feat: add new feature (<ISSUE-ID>)
Description of feature.
Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
Co-Authored-By: GitHub Copilot <[email protected]>
git add src/module.ext test/module.test.ext
Important: Stage tests and implementation together!
Run unit tests (and integration tests if needed) using the project's test execution skill.
Using heredoc for proper formatting:
git commit -m "$(cat <<'EOF'
feat: add new feature (<ISSUE-ID>)
Detailed description of the feature.
Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
EOF
)"
Or interactive:
git commit
# Opens editor for commit message
git log -1 --pretty=format:"%h %s"
git show HEAD --stat
# 1. Write tests
# 2. Implement feature
# 3. Run tests using the project's test execution skill
# 4. Stage changes (tests + implementation together)
git add src/validation.ext test/validation.test.ext
# 5. Commit
git commit -m "$(cat <<'EOF'
feat: add input validation helper (<ISSUE-ID>)
Add validateInput function for common input validation patterns.
Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
EOF
)"
# 1. Write test reproducing bug
# 2. Fix bug
# 3. Run tests using the project's test execution skill
# 4. Stage and commit
git add src/validation.ext test/validation.test.ext
git commit -m "$(cat <<'EOF'
fix: handle null input in validation (<ISSUE-ID>)
Add null check before string operations to prevent null reference error.
Closes #123
Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
EOF
)"
git add README.md
git commit -m "docs: update installation instructions (<ISSUE-ID>)"
git add test/validation.test.ext
git commit -m "test: add coverage for edge cases (<ISSUE-ID>)"
See commit-templates.md for more examples.
Closes #123 for fixesRun tests using the project's test execution skill with detailed verbosity to see failures. Fix failing tests, run tests again, and commit once all tests pass.
# Check what's staged
git status
# Stage missing test files
git add test/
# Amend previous commit (if not pushed)
git commit --amend
# Amend commit (if not pushed)
git commit --amend
# Add co-author line in editor
Run integration tests using the project's test execution skill. If they pass, commit.
npx claudepluginhub xxthunder/xxthunder-agentic-skills --plugin xxthunder-dev-skillsGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.