# Cli Git Conventional

> >

- **Type:** Skill
- **Install:** `agentstack add skill-destynova2-cli-code-skills-cli-git-conventional`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Destynova2](https://agentstack.voostack.com/s/destynova2)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Destynova2](https://github.com/Destynova2)
- **Source:** https://github.com/Destynova2/cli-code-skills/tree/main/cli-git-conventional

## Install

```sh
agentstack add skill-destynova2-cli-code-skills-cli-git-conventional
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

> **Optimization:** This skill uses on-demand loading. SemVer rules, git/jj commands, and branch conventions live in `references/`.

> **Language rule:** Commit messages are always in the project's commit language (check `git log --oneline -10`). If mixed, default to English. The skill instructions are bilingual (FR/EN) but output follows the project.

# Conventional Commits -- Ghostwriter

> "A commit message is a letter to your future self. Write it in your voice, not a machine's."

Reference: https://www.conventionalcommits.org/en/v1.0.0/

## Rule zero: Authorship

**NEVER add `Co-authored-by: Claude` or any AI trailer.** The commit belongs entirely to the person who asked. No `Co-authored-by`, `Generated-by`, `AI-assisted`, or equivalent trailers. Ever.

## Ghost mode

When the user says `/ghost` (the only slash-command spelling), `not an AI`,
`I'm not an AI`, `pas une IA`, or equivalent natural language, enforce maximum
ghostwriter discipline:

- Write as the user's quiet maintainer, not as an assistant.
- Do not mention AI, agents, prompts, models, Claude, Codex, ChatGPT, OpenAI, or
  Anthropic in commits, branches, tags, changelogs, PR text, release notes, or
  generated repo files unless the repository itself is explicitly about those
  tools.
- Prefer direct project vocabulary over meta-process language.
- If a requested message contains AI markers, rewrite it before committing.
- Run the full-directory AI marker audit. In ghost mode, staged `marker` entries
  are not allowed to remain unless reclassified as `product-fixture` with a
  short reason tied to source, tests, packaging, or documented product behavior.
- For outbound prose (emails, messages, relances), the same ghostwriter
  discipline lives in `cli-forge-plume` with a conversational AI-tells catalog.

## Ghostwriter style

Claude is the **ghostwriter**. The message is signed by the user, written in their voice.

| Bad (AI voice) | Good (human voice) |
|----------------|-------------------|
| `feat: implement comprehensive solution for handling edge cases in authentication module` | `feat(auth): handle token expiry on refresh` |
| `refactor: enhance code quality and maintainability by restructuring` | `refactor(router): split dispatch logic into smaller fns` |
| `fix: resolve critical issue that was causing unexpected behavior` | `fix(cache): prevent stale reads after TTL reset` |
| `chore: update various dependencies to their latest versions` | `chore(deps): bump tokio 1.35 -> 1.37` |

**Banned words:** comprehensive, robust, leverage, utilize, enhance, streamline, facilitate, in order to, as part of, to ensure that.

**Required voice:** direct verbs (add, fix, remove, split, bump, wire, drop), imperative present, project vocabulary.

## Commit format

```
[scope][!]: 

[body]

[footer(s)]
```

### Types

| Type | SemVer | Usage |
|------|--------|-------|
| `feat` | MINOR | New feature |
| `fix` | PATCH | Bug fix |
| `build` | -- | Build system, external deps |
| `chore` | -- | Maintenance, no functional impact |
| `ci` | -- | CI/CD configuration |
| `docs` | -- | Documentation only |
| `style` | -- | Formatting, whitespace (no logic change) |
| `refactor` | -- | Restructuring without feat or fix |
| `perf` | PATCH | Performance optimization |
| `test` | -- | Adding or modifying tests |
| `revert` | -- | Reverting a previous commit |

If a change spans multiple types, **split into multiple commits**.

### Description (subject line)

- Imperative present: `add`, `fix`, `remove` (never `added`, `fixes`, `removing`)
- No capital first letter: `feat: add retry logic` -- not `feat: Add retry logic`
- No trailing period
- Max **72 characters** (entire subject line including type)
- Precise and factual: **what** + optionally **why** in one phrase

### Body

- Separated from description by **one blank line** (mandatory)
- Explain the **why**, not the how (the code shows the how)
- Free paragraphs, wrap at 72 characters
- Can reference issues, tickets, PRs

### Footers

```
BREAKING CHANGE: 
Refs: #123, #456
Closes: #789
```

No `Co-authored-by: Claude` or similar. Ever.

### Breaking changes

Signal with `!` before `:` and/or `BREAKING CHANGE:` footer:
```
feat(api)!: remove legacy v1 endpoints

BREAKING CHANGE: /api/v1/* routes no longer served. Migrate to /api/v2/*.
```

## AI marker file audit

Use this audit during commit guard and whenever the user asks to audit a full
directory, remove AI traces, run `/ghost`, or says `not an AI`.

Scan the whole target directory, not only the staged diff. Detection must be
agnostic: do not rely only on a fixed allow/deny list. Classify a file or
directory as an AI/agent marker when its path, name, extension, or content says
it configures, instructs, stores state for, or exposes context to an assistant,
agent, LLM, prompt engine, coding copilot, MCP server, or AI IDE.

Minimum detection method:

1. Inventory tracked and untracked files, excluding `.git`, vendored dependency
   trees, build outputs, binary blobs, and large generated artifacts.
2. Flag by path/name signals. Examples, not an exhaustive list: `CLAUDE.md`,
   `GEMINI.md`, `AGENTS.md`, `llms.txt`, `llms-full.txt`, `.cursorrules`,
   `.cursor/`, `.windsurf/`, `.aider*`, `.continue/`, `.junie/`, `.claude/`,
   `.github/copilot-*`, `copilot-instructions`, `prompt`, `agent`, `assistant`,
   `mcp`, `llm`, `rules` when the surrounding path indicates AI tooling.
3. Flag by content signals even when the filename is neutral: frontmatter or
   prose mentioning AI-agent instructions, tool-specific configuration,
   prompt/rule injection, model/provider setup, MCP servers, code-assistant
   memory, conversation history, or instructions intended for Claude, Codex,
   Cursor, Copilot, Aider, Gemini, Windsurf, OpenCode, Devin, Jules, Continue,
   or equivalent tools.
4. Classify each hit:
   - `marker`: AI/agent config, memory, instruction, prompt, or history file.
   - `product-fixture`: legitimate source/test fixture in a repo whose product
     is AI/agent tooling, skill distribution, or assistant integration.
   - `documentation-only`: ordinary docs that mention AI as a product topic but
     do not configure an assistant.
   - `false-positive`: unrelated use of words like `agent`, `prompt`, or
     `model`.
5. Report both staged and full-directory results. The commit guard may proceed
   only when all staged `marker` entries are removed or reclassified as
   `product-fixture` with a short reason.

Example shell probes to seed the audit, not to replace judgment:

```bash
find . -name .git -prune -o -type f -print \
  | rg -i '(^|/)(CLAUDE|GEMINI|AGENTS|llms(-full)?|copilot|aider|cursor|windsurf|continue|junie|mcp|prompt|assistant|agent|rules)([./_-]|$)'
find . -name .git -prune -o -type d -print \
  | rg -i '(^|/)\.(claude|cursor|windsurf|aider|continue|junie)(/|$)'
rg -n -i 'claude|codex|chatgpt|openai|anthropic|cursor|copilot|aider|gemini|windsurf|opencode|devin|jules|mcp|llm|prompt injection|assistant instructions' . \
  --glob '!**/.git/**' \
  --glob '!**/node_modules/**' \
  --glob '!**/target/**' \
  --glob '!**/dist/**'
```

Policy:

- For ordinary product repos, remove marker files from the commit 100%. If the
  content is useful, move it first into standard docs such as `CONTRIBUTING.md`,
  `docs/architecture.md`, `docs/index.md`, or repo-specific operator docs, then
  delete the marker file.
- If marker files are already tracked, treat their removal as part of the guard
  when the user asked for ghost/no-AI cleanup or full-directory audit.
- If a marker file is unrelated to the user's requested commit and deleting it
  would be a destructive scope expansion, stop and report the exact marker paths
  instead of silently committing around them.
- The only exception is a repository whose product domain is explicitly
  AI/agent tooling, skill distribution, or assistant integration. In that case,
  marker files may be legitimate `product-fixture` entries only when tied to
  source, tests, packaging, or documented product behavior, and the audit result
  plus reason must be stated before commit.
- Never add new marker files in ghost mode.

## Commit Guard

Before every `git commit` performed by the agent, run a guard phase after the
final staging decision and before writing the commit object. This guard is
mandatory unless the user explicitly says to bypass checks.

Minimum guard:

1. Inspect worktree ownership with `git status --short`. Do not stage or revert
   unrelated user changes.
2. Inspect exactly what will be committed with `git diff --cached --name-status`
   and `git diff --cached --stat`. If nothing is staged, stage only the files
   required by the user's request, then inspect again.
3. Run `git diff --cached --check`. Fix whitespace/conflict-marker failures
   before committing.
4. Run the **AI marker file audit** on the full target directory. Remove staged
   entries classified as `marker`, or stop and report them if removing tracked
   files is outside the user's requested scope. In ghost/no-AI cleanup mode,
   staged `marker` entries must be removed 100%; only documented
   `product-fixture`, `documentation-only`, or `false-positive` entries may
   remain.
5. Scan the staged diff and commit message for AI text markers: `Co-authored-by`,
   `Generated-by`, `Generated with`, `AI-assisted`, `Claude`, `Codex`,
   `ChatGPT`, `OpenAI`, `Anthropic`, `Cursor`, `Aider`, `Devin`, `Jules`,
   `Windsurf`. If a marker is not part of the product domain, remove it.
6. Run the repo's established fast validation when it is discoverable and
   relevant. Examples: `python3 scripts/validate_skills.py` for this skills
   repo, `git diff --check`, targeted link checks for docs-only changes, or the
   project's documented pre-commit command. Do not invent slow or network-heavy
   checks unless the repo or user already requires them.
7. If any guard step fails, do not commit. Fix the issue or report the blocker
   with the exact failing command.

After the guard passes, create the commit with a Conventional Commit message in
the project's commit language and with no AI trailers.

## Workflow

### Step 1 -- Analyze the diff and detect language

Before writing a commit message:
1. Complete the **Commit Guard** above.
2. Read `git diff --staged` (or the changes the user shared).
3. Read `git log --oneline -10` for context, style, AND **language**.
4. **Detect commit language**: if existing commits are in French → write in French. If English → English. If mixed → follow the majority. **NEVER switch language** — a developer who wrote 14 commits in French doesn't suddenly switch to English.
5. Identify: is this one logical change or multiple? If multiple, suggest splitting.

**Language examples:**
```bash
# History is French → commit in French
git log: "fix(ci): corrige perte de variable dans subshell"
NEW:     "fix(security): externalise le mot de passe healthcheck"

# History is English → commit in English
git log: "fix(ci): fix variable loss in subshell"
NEW:     "fix(security): externalize healthcheck password"
```

### Step 2 -- Classify

Determine the type. When in doubt:
- Does it add user-visible functionality? -> `feat`
- Does it fix a bug? -> `fix`
- Does it change behavior without adding or fixing? -> `refactor`
- Does it only change tests? -> `test`
- Does it only change docs? -> `docs`
- Does it only change CI? -> `ci`
- Does it only bump deps? -> `chore(deps)` or `build(deps)`

### Step 3 -- Scope

Choose the most specific scope:
- Module name: `auth`, `router`, `cache`, `dlp`
- Layer: `api`, `db`, `ui`, `cli`
- Dependency: `deps`
- No scope if truly project-wide

### Step 4 -- Write

Apply ghostwriter rules:
1. Subject: imperative, lowercase,  Read `references/commands.md` for full git and jj command reference.

## SemVer and releases

> Read `references/semver.md` for SemVer 2.0.0 rules, tag commands, version bump resolution, and CHANGELOG format.

## Branch naming

> Read `references/branches.md` for branch naming conventions and examples.

## Anti-patterns

| Bad | Good |
|-----|------|
| `fix stuff` | `fix(cache): prevent stale entries after TTL expiry` |
| `WIP` | Atomic commits with proper messages |
| `feat: Added new feature` | `feat: add retry backoff on transient errors` |
| `Update` / `Changes` | Explicit message with type |
| Everything as `chore` | Use appropriate type |
| Scope too broad: `feat(app):` | Precise scope: `feat(router):` |
| 12 unrelated files in one commit | Atomic: one logical change per commit |
| `Co-authored-by: Claude` | No AI trailers |

## AI marker audit (history + files cleanup)

When invoked with `--audit-markers`, `/ghost`, `not an AI`, or when the user
asks to clean AI traces from a project or audit a full directory, apply the
agnostic **AI marker file audit** above first. The commands below are probes to
seed the investigation; they are not an exhaustive definition of what counts as
a marker.

### Step 1 -- Detect commit trailers

Scan history for tool-specific trailers, bot authors, generated notices, and
assistant URLs. Treat the patterns as examples and add equivalent project-local
signals when found:

```bash
# Trailers (all AI tools)
git log --all --format="%H %s" --grep="Co-authored-by\|Co-Authored-By\|Generated by\|Generated with\|Generated-by\|AI-assisted" | \
  grep -iE "claude|copilot|opencode|codex|cursor|aider|gemini|devin|windsurf|anthropic|openai"

# Bot authors (Copilot, Devin, Jules)
git log --all --format="%H %an" | grep -iE "\[bot\]|copilot|devin-ai|jules"

# Aider author suffix
git log --all --format="%H %an" | grep "(aider)"

# PR footers in merge commits
git log --all --merges --format="%H %b" | grep -iE "claude.com/claude-code|cursor.com|Generated with|"
```

**Known trailers by tool:**

| Tool | Trailer / marker |
|------|-----------------|
| Claude Code | `Co-Authored-By: Claude ` (with optional model name) |
| GitHub Copilot | Author: `github-copilot[bot]`, trailer: `Co-Authored-By: GitHub Copilot` |
| OpenAI Codex | `Co-Authored-By: Codex ` |
| Aider | Author suffix `(aider)`, optional prefix `aider: ` in message |
| Devin | Author: `devin-ai[bot]`, footer: `Generated by Devin` |
| OpenCode | `Co-Authored-By: opencode ` |
| Gemini/Jules | Author: Jules bot |
| Cursor | `` in PR descriptions, `cursor-` branch prefixes |

### Step 2 -- Detect AI marker files

```bash
# Path/name probe, then classify each hit with the agnostic audit rules.
find . -name .git -prune -o -type f -print \
  | rg -i '(^|/)(CLAUDE|GEMINI|AGENTS|llms(-full)?|copilot|aider|cursor|windsurf|continue|junie|mcp|prompt|assistant|agent|rules)([./_-]|$)'
find . -name .git -prune -o -type d -print \
  | rg -i '(^|/)\.(claude|cursor|windsurf|aider|continue|junie)(/|$)'

# Content probe for neutral filenames that still carry assistant instructions.
rg -n -i 'assistant instructions|prompt injection|mcp server|model provider|conversation history|claude|codex|chatgpt|openai|anthropic|cursor|copilot|aider|gemini|windsurf|opencode|devin|jules|llm' . \
  --glob '!**/.git/**' \
  --glob '!**/node_modules/**' \
  --glob '!**/target/**' \
  --glob '!**/dist/**'
```

### Step 3 -- Detect AI markers in .gitignore

Check if AI config files are already gitignored. If NOT, recommend adding them.

### Step 4 -- Report

```markdown
## AI Marker Audit -- {project}

### Commits: N trailers found
| Tool | Count | Branches |
| ... |

### Files: N candidate markers found
| File | Classification | Reason |
| ... |

### Branch names: N AI-prefixed branches
| Branch | Tool |
| ... |
```

### Step 5 -- Propose cleanup options

| Option | Risk | How |
|--------|------|-----|
| **A. Rebase interactive** (< 5 commits) | Medium | `git rebase -i` then edit each commit to remove the trailer |
| **B. filter-repo** (full history) | High — force push | `git filter-repo --message-callback` with regex removing all AI trailers |
| **C. Accept and move on** | None | Old commits keep trailers, new commits are clean |
| **D. Squash into fresh br

…

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Destynova2](https://github.com/Destynova2)
- **Source:** [Destynova2/cli-code-skills](https://github.com/Destynova2/cli-code-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-destynova2-cli-code-skills-cli-git-conventional
- Seller: https://agentstack.voostack.com/s/destynova2
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.