install
source · Clone the upstream repo
git clone https://github.com/Tatsh/dbeaver-creds
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Tatsh/dbeaver-creds "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/ci" ~/.claude/skills/tatsh-dbeaver-creds-ci && rm -rf "$T"
manifest:
.claude/skills/ci/SKILL.mdsource content
Commit
Create high-quality Git commits for all pending changes.
Gathering context
Run these in parallel:
- unstaged changes.git diff
- staged changes.git diff --cached
- untracked files and overall state.git status
- recent commit message style examples.git log --no-merges --format='%s%n%b---' -20 | grep -v '^bump:' | grep -iv dependabot
Running agents
After gathering context but before committing, determine which agents to run based on the changed files. Launch each agent sequentially using the Agent tool with subagent_type
general-purpose,
telling it to follow the corresponding .claude/agents/<name>.md file. Scope each agent to only the
changed files, not the entire project.
When user-facing changes are being committed
- changelog - update
with entries for the changes. After it completes, check ifCHANGELOG.md
was modified (CHANGELOG.md
). If it was, it will be staged together with the relevant commit. Only run when changes affect users: files undergit diff CHANGELOG.md
, or dependency/version changes. Skip for: workflows, CI config,dbeaver_creds/
,.claude/
,.cursor/
, documentation-only changes, and other non-user-facing files..github/instructions/
Analysing changes
Group changed files by component. Determine if one commit or multiple logical commits are needed.
Incidental files
The following files do not count when determining the component prefix, unless they are the only file in a commit:
CHANGELOG.md.vscode/dictionary.txt
For example, if a commit contains
dbeaver_creds/main, and CHANGELOG.md, the component is
determined by the source files only. CHANGELOG.md is simply staged alongside them.
If
CHANGELOG.md is the only file being committed, use the changelog: prefix. If
.vscode/dictionary.txt is the only file, use dictionary: prefix.
When to split into multiple commits
- Changes span unrelated components.
- A refactor and a bug fix in the same file should be separate commits.
- New tests for existing code should be separate from the code changes they test only if the code changes are themselves separate.
- Dictionary updates (
) should be committed first with message.vscode/dictionary.txt
.dictionary: update
Cruft updates
When all changes are from re-running Wiswa (the project generator) and no hand-written code changed, this is a cruft update. Indicators:
- Only Wiswa-managed files changed (workflows,
,package.json
,.pre-commit-config.yaml
,.claude/agents/
,.cursor/rules/
,.github/instructions/
,CITATION.cff
,.vscode/dictionary.txt
, etc.)..wiswa.jsonnet - No files under the primary module or source directories changed.
Commit everything in a single commit with the subject
cruft: update. Include a body summarising
what changed (e.g. new/updated workflows, updated agent files, dependency version bumps, new managed
files). Do not run any agents. Do not split into multiple commits. Do not update the changelog.
When a single commit is fine
- All changes serve the same purpose within a closely related set of files.
- A bug fix and its test.
Commit message format
component.name: short description Optional longer description explaining the why, not the what. Wrap at 72 characters. Signed-off-by: Author Name <email> Closes: #123
Subject line rules
- Format:
. Component name must be lowercase and must skip the first period if present (component.name: short description
notvscode
,.vscode
->README.md
notreadme
), and must omit the period with extension.README - Lowercase after the colon (unless a proper noun).
- No period at the end.
- Maximum 72 characters.
- Use imperative mood: 'add', 'fix', 'update', 'remove', not 'added', 'fixes', 'updated'.
Component prefix rules
- Workflow file
→.github/workflows/qa.yml
.workflows/qa: - Multiple workflows →
.workflows/*: - Agent files
→.claude/agents/*.md
or specific agent name..claude: - Instruction files across all 3 locations →
(since they span Copilot/Cursor/Claude).project: - Dictionary
→.vscode/dictionary.txt
(only when committed alone).dictionary: - Top-level config (
,package.json
) →package.json
.project: - If changes span many unrelated areas →
.project: - CHANGELOG.md →
(only when committed alone).changelog: - CONTRIBUTING.md →
.contributing:
Trailers
- when a commit closes an issue. If it is another project, use the full URI.Closes: #N
- when a commit fixes a bug reported in an issue. If it is another project, use the full URI.Fixes: #N
- when a commit is related to an issue but does not fully close or fix it. If it is another project, use the full URI.Related: #N
- if applicable.Reviewed-by:
- if applicable.Co-authored-by:
: - if applicable. Could get this information from a bug report that led to the fix if the issue ID/URL is known.Reported-by:
- always included on every commit. This will be added withSigned-off-by:
.-s
Making commits
- Stage files for each logical commit using
with specific file paths.git add - If
was updated by the changelog agent, stage it with the relevant commit.CHANGELOG.md - Create a unique temp file with
, write the commit message there using the Write tool (not Bashmktemp /tmp/commit-msg-XXXXXXXX
), then commit withcat
. Multiple Claude instances may run concurrently, so never use a fixed path.git commit -S -s -F <tempfile> - If a pre-commit hook fails, fix the issue, re-stage (use appropriate agent if there is one), and try to commit again.
- After all commits, run
to verify clean state.git status
Rules
- Never use
or--no-verify
.--no-gpg-sign - Amend the previous commit when the new change is logically part of it (e.g. same file, same topic, fixing something just committed). Create a new commit when the change is distinct.
- Never push unless explicitly asked.
- Always use
for GPG signing and-S
for sign-off.-s - If there are no changes, do nothing.
- Stage specific files, never use
orgit add -A
.git add .