contextual-commit SKILL.md skillA

contextual-commit from yamadashy/repomix is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add yamadashy/repomix/contextual-commit@git:20260524.a01d836

Pins git:20260524.a01d836 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
yamadashy/repomix
Path
.agents/skills/contextual-commit/SKILL.md
Versions recorded
1
Latest version
git:20260524.a01d836, committed May 24, 2026
Size
10,683 bytes
Repository stars
29,174
License
MIT

Write contextual commits that capture intent, decisions, and constraints alongside code changes. Use when committing code, finishing a task, or when the user asks to commit. Extends Conventional Commits with structured action lines in the commit body that preserve WHY code was written, not just WHAT changed.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Contextual Commits

You write commits that carry development reasoning in the body — the intent, decisions, constraints, and learnings that the diff alone cannot show.

## The Problem You Solve

Standard commits preserve WHAT changed. The diff shows that too. What gets lost is WHY — what the user asked for, what alternatives were considered, what constraints shaped the implementation, what was learned along the way. This context evaporates when the session ends. You prevent that.

## Commit Format

The subject line is a standard Conventional Commit. The body contains **action lines** — typed, scoped entries that capture reasoning.

```
type(scope): subject line (standard conventional commit)

action-type(scope): description of reasoning or context
action-type(scope): another entry
```

### Subject Line

Follow Conventional Commits exactly. Nothing changes here:
- `feat(auth): implement Google OAuth provider`
- `fix(payments): handle currency rounding edge case`
- `refactor(notifications): extract digest scheduling logic`

### Action Lines

Each line in the body follows: `action-type(scope): description`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add yamadashy/repomix/contextual-commit@sha256:e285c7f26f6da9e8

The line at the top of this page pins the label git:20260524.a01d836, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_toc2alwf5fghgsqs.svg)](https://markdownregistry.com/a/art_toc2alwf5fghgsqs)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 24, 2026.

versioncommittedcommitsizeaudit
git:20260524.a01d836 latest2026-05-24 a01d836 10,683 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10683 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

yamadashy/repomix · 29,174 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_toc2alwf5fghgsqs
GET https://markdownregistry.com/api/v1/resolve?ref=yamadashy/repomix/contextual-commit
GET https://markdownregistry.com/api/v1/blob/e285c7f26f6da9e818fc8b8d4ae2ed720487f53a352c307f60ebe7a75bba0099

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from yamadashy/repomix

repomix SKILL.md skill
yamadashy/repomix · .agents/clawhub/SKILL.md · Pack and analyze codebases into AI-friendly single files using Repomix. Use when the user wants to explore…
v1.0.0 · audit A · 29,174 stars
agent-carnet SKILL.md skill
yamadashy/repomix · .agents/skills/agent-carnet/SKILL.md · Use this skill when the user asks to save, recall, find, or organize notes. Triggers on: 'remember this', 'save this'…
git:20260524.a01d836 · audit A · 29,174 stars
base Cursor rule
yamadashy/repomix · .cursor/rules/base.mdc
git:20250715.b058f8f · audit B · 29,174 stars
AGENTS.md AGENTS.md file
yamadashy/repomix · AGENTS.md
git:20250912.d020d0d · audit B · 29,174 stars
CLAUDE.md CLAUDE.md file
yamadashy/repomix · CLAUDE.md
git:20250711.4e5812b · audit B · 29,174 stars
browser-extension-developer SKILL.md skill
yamadashy/repomix · browser/.claude/skills/browser-extension-developer/SKILL.md · Use this skill when developing or maintaining browser extension code in the `browser/` directory, including…
git:20260123.6390e9c · audit A · 29,174 stars
CLAUDE.md@browser CLAUDE.md file
yamadashy/repomix · browser/CLAUDE.md
git:20250618.27dc9e0 · audit A · 29,174 stars
repomix-explorer SKILL.md skill
yamadashy/repomix · skills/repomix-explorer/SKILL.md · Analyze or explore a codebase (remote or local repository) by packing it with the Repomix CLI, then reading and…
git:20260525.35c2e86 · audit A · 29,174 stars
website-maintainer SKILL.md skill
yamadashy/repomix · website/.claude/skills/website-maintainer/SKILL.md · Use this skill when working on the Repomix documentation website in `website/` directory, including VitePress…
git:20260123.6390e9c · audit A · 29,174 stars

Every file in yamadashy/repomix

Browse by kind, by grade A, or by owner.