# Jj:describe

> Generate and set a commit description for a commit in jj

- Skill: `majiayu000/jj-describe` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/jj-describe`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/jj-describe/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/jj-describe

---


# Describe a Commit

Generate and set a commit description. Defaults to `@` (working copy), but typically used on `@-` (parent) when working copy is empty.

## Process

1. Run `jj show <rev> --summary` and `jj diff -r <rev> --stat` to get change overview (use `@-` for parent)
2. Analyze changes:
   - Small (≤5 files, ≤200 lines): run `jj diff -r <rev>` directly
   - Large: use `/jj-context` for structured summary
3. Determine project prefix from file paths
4. Generate a **one-line** description: `<prefix>: <lowercase verb> <what changed>`
5. Run `jj describe <rev> -m "<description>"` (e.g., `jj describe @- -m "..."`)

**IMPORTANT**: Always use a single-line commit message. Never use multi-line descriptions or bullet points.

## Project Prefix Examples

Use the descriptive folder path identifying the subsystem:
- `src/auth` for authentication code
- `lib/utils` for utility libraries
- `services/api` for API services
- `db/migrations` for database changes

## Good Description Examples

- `src/auth: add JWT token refresh logic`
- `lib/utils: fix date parsing for ISO formats`
- `services/api: add rate limiting middleware`
- `db/migrations: add users table`
- `tests/integration: add checkout flow tests`