Commit Convention
Write conventional commit messages and run the repository's pre-push checks before commit, push, or PR title work.
This skill is a thin loader for the colocated skill.spec.yml. The spec is the source of truth for routes, rules, dependencies, imports, resources, recipes, tests, and trace requirements.
Runtime Contract
Load ./skill.spec.yml from this skill folder before taking task actions.
When the skillspec CLI is available, run:
skillspec decide ./skill.spec.yml --input='<user task>' --trace-dir "${PWD}/.skillspec/traces"
Strip skill invocation prefixes such as /my-skill, $my-skill, or /rote-shell-spec before passing --input.
Preserve the emitted trace run_dir.
When the CLI is available after a trace exists, run skillspec trace align ./skill.spec.yml --decision-trace <run_dir> and report the alignment status with the trace path.
Follow the selected route, matched rules, forbids, elicitations, dependencies, imports, recipes, and closures from skill.spec.yml.
If the CLI is unavailable, read skill.spec.yml directly and apply its rules manually. Do not expand this loader into a second source of truth.
Quick Commands
skillspec validate ./skill.spec.yml
skillspec imports check ./skill.spec.yml
skillspec test ./skill.spec.yml
skillspec deps check ./skill.spec.yml
skillspec explain ./skill.spec.yml --input='<user task>' --trace-dir "${PWD}/.skillspec/traces"
skillspec trace align ./skill.spec.yml --decision-trace "${PWD}/.skillspec/traces/<run-id>"
Completion Report
When reporting completion, include the selected route, the SkillSpec trace run_dir, the skillspec trace align status (pass, fail, or unproven), key failed or unproven alignment checks, and the concrete execution evidence ids or files.
Route Hints
message_only: Draft commit message onlypre_push_gate: Run pre-push checkscommit_ready: Prepare commit-ready output
1---2name: generic-commit-convention3description: Write conventional commit messages and run the repository's pre-push checks before commit, push, or PR title work.4---56# Commit Convention78Write conventional commit messages and run the repository's pre-push checks before commit, push, or PR title work.910This skill is a thin loader for the colocated `skill.spec.yml`. The spec is the source of truth for routes, rules, dependencies, imports, resources, recipes, tests, and trace requirements.1112## Runtime Contract13141. Load `./skill.spec.yml` from this skill folder before taking task actions.152. When the `skillspec` CLI is available, run:1617 ```bash18 skillspec decide ./skill.spec.yml --input='<user task>' --trace-dir "${PWD}/.skillspec/traces"19 ```20213. Strip skill invocation prefixes such as `/my-skill`, `$my-skill`, or `/rote-shell-spec` before passing `--input`.224. Preserve the emitted trace `run_dir`.235. When the CLI is available after a trace exists, run `skillspec trace align ./skill.spec.yml --decision-trace <run_dir>` and report the alignment status with the trace path.246. Follow the selected route, matched rules, forbids, elicitations, dependencies, imports, recipes, and closures from `skill.spec.yml`.257. If the CLI is unavailable, read `skill.spec.yml` directly and apply its rules manually. Do not expand this loader into a second source of truth.2627## Quick Commands2829```bash30skillspec validate ./skill.spec.yml31skillspec imports check ./skill.spec.yml32skillspec test ./skill.spec.yml33skillspec deps check ./skill.spec.yml34skillspec explain ./skill.spec.yml --input='<user task>' --trace-dir "${PWD}/.skillspec/traces"35skillspec trace align ./skill.spec.yml --decision-trace "${PWD}/.skillspec/traces/<run-id>"36```3738## Completion Report3940When reporting completion, include the selected route, the SkillSpec trace `run_dir`, the `skillspec trace align` status (`pass`, `fail`, or `unproven`), key failed or unproven alignment checks, and the concrete execution evidence ids or files.4142## Route Hints4344- `message_only`: Draft commit message only45- `pre_push_gate`: Run pre-push checks46- `commit_ready`: Prepare commit-ready output
modiqo