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

diff --git a/.agents/skills/issues/SKILL.md b/.agents/skills/issues/SKILL.md
index 225d95c..104a04c 100644
--- a/.agents/skills/issues/SKILL.md
+++ b/.agents/skills/issues/SKILL.md
@@ -23,9 +23,19 @@ 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.
+- When a question to the user is still open at the end of a session, add
+  it as a comment with the options and your recommendation. Add the
+  answer as a comment when it comes.
+- Give the reason with each decision, so that a later agent does not
+  undo it.
 - Close an issue with `git bug bug status close ID` only when its check
   passes.
 - Label a phase `phase`, an open question `decision`, and the plan
@@ -55,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"
 ```