X-Git-Url: https://git.giacomolli.uk/onechat/blobdiff_plain/d20d4c6b2aa7bceddced27be9b24ed171f38696f..0a98ccb:/.agents/skills/issues/SKILL.md

diff --git a/.agents/skills/issues/SKILL.md b/.agents/skills/issues/SKILL.md
index f782536..104a04c 100644
--- a/.agents/skills/issues/SKILL.md
+++ b/.agents/skills/issues/SKILL.md
@@ -23,6 +23,11 @@ commands in the Nix development shell.
   imperative mood, with no final period.
 - Write the body in Markdown. State the result for the user, the scope,
   and how to check it.
+- Format each body and comment with `mdformat -` in the repository, so
+  that it uses `.mdformat.toml`. mdformat joins trailer lines into one
+  line, so format the text first and add the trailers after it.
+- Quote a long text as a blockquote below the paragraph or list, not as
+  inline code. mdformat cannot wrap inline code.
 - Add a comment with `git bug bug comment new ID -m TEXT` for progress
   that matters: decisions made with the user, measurements, and checks
   that could not run.
@@ -60,6 +65,9 @@ Push the issues with `git bug push` when the repository has a remote.
 This example creates an issue:
 
 ```sh
+body=$(mdformat - < body.md)
 git bug bug new --non-interactive -t 'Decide the root wake interval' \
-  -m "$(cat body.md)"
+  -m "$body
+
+Parent: 180a674"
 ```