Menu
Use when 🤖{} or 🤖[] or 🤖~~ markers appear in markdown documents
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
use to learn from existing coding sessions, or record hints
Use when the user is requesting an artifact (capture, save, record, create) AND the substance to preserve is conversational context they've already produced. Skip when the user is stating facts, asking questions, or asking the agent to generate substance from scratch. Also trigger when editing markdown with known frontmatter type:
Use when editing issues in workshop/issues/.
Use to process interview feedback
apply a voice style
Generate a writing style guide
| name | xx-fix |
| description | Use when 🤖{} or 🤖[] or 🤖~~ markers appear in markdown documents |
Process 🤖 inline markers in a file, following the review convention
documented in the ariadne workshop target review-convention.md. That target
is the canonical grammar; this skill is the agentic side of it.
/fix <path-to-file>
marker ::= 🤖 reference? section*
reference ::= "<" TEXT ">" | "~" TEXT "~" -- optional, at most one, first slot only
section ::= "[" TEXT "]" | "{" TEXT "}"
Two reference enclosures (anchor to prior text):
<X> — text quoted from the prior edition; preserved on resolve.~X~ — text marked for deletion; markdown strikethrough renders the preview.Two commentary enclosures (alternate freely):
[] = always human (comments, corrections, instructions, replacements).{} = always agent (findings, suggestions, questions, responses).After the optional reference, any chain of []/{} sections in any order:
🤖{agent finding}[human response]{agent follow-up}[human reply]...
🤖[human comment]{agent response}[human reply]{agent response}...
🤖<quoted text>[human instruction about that text]
🤖~old text~ -- robot proposes deletion
🤖~old text~{new text} -- robot proposes replacement
🤖~old text~[new text] -- human-authored replacement
| Marker | Meaning |
|---|---|
🤖{needs citation} | Agent flagged an issue, awaiting human |
🤖{needs citation}[added ref to Smith 2024] | Human responded — actionable |
🤖{needs citation}[] | Human says "go ahead" — actionable |
🤖[fix this typo] | Human comment — actionable |
🤖<foo_bar>[rename to foo_baz] | Human scopes instruction to the quoted text — actionable |
🤖~old phrase~[new phrase] | Human-authored replacement — actionable (apply per §5) |
🤖~old phrase~ | Robot proposed a deletion, awaiting human — skip |
🤖~old phrase~{better phrase} | Robot proposed a replacement, awaiting human — skip |
🤖[fix this typo]{did you mean "their" → "there"?} | Agent asked for clarification, awaiting human |
🤖[] | Bare empty marker with no prior context — skip |
🤖{} | Empty agent marker — skip |
One rule: if the last section is [], act. Otherwise, skip.
References (<X>, ~X~) are not sections — 🤖<Q> alone or 🤖<Q>{A} is not
actionable; a bare 🤖~D~ (or 🤖~D~{N}) is a robot-authored edit proposal
awaiting the operator's Alt+a / Alt+r in parley.nvim, so /xx-fix skips it.
An empty [] means "go ahead" — the human approves the agent's prior
suggestion without additional instructions, or asks the agent to do its best.
Markers inside fenced code blocks are ignored.
sources and
source_precedence are present, load them — use these to guide re-research
when a marker flags a factual correction. Prefer sources in the stated
precedence order (typically: codebase > Jira > doc text). If no frontmatter,
proceed without re-research guidance.㊷ aliases), checking the rightmost section
to decide actionability. Skip non-actionable markers.[]), read the
full chain, then:
🤖~D~[N] (no robot reply after): the operator
authored a literal replacement — substitute D with N in the surrounding
text and remove the marker. This is the §5 accept path.🤖[H] or 🤖<X>[H]: interpret H as a directive.
If H is a factual correction, consult frontmatter sources before
rewriting — do not just rephrase. Apply the change and remove the marker.🤖{R}[H], 🤖<X>{R}[H], 🤖~D~{R}[H],
etc.: H is the operator's response to the robot's prior {R}. Read both;
H may be "yes apply R" (→ apply R and remove the marker) or a new
instruction overriding R (→ apply H, remove the marker).{agent feedback} to the
marker (so it ends in {} — non-actionable until the human responds), and
send the verbose reasoning in the coding-session reply.{your question here} to the marker.A feedback session is complete when no marker ending in [] remains in
the document. Remaining markers ending in {} (or bare edit proposals like
🤖~D~, 🤖~D~{N}) are awaiting the human's next gesture.
When the operator says something like "we're aligned, please resolve the
outstanding markers", you are explicitly authorized to walk every remaining
chain and apply the §5 accept/reject table from the review convention. For
each chain, read the last commentary block — typically the trailing [H] —
and interpret it as accept or reject. Do not resolve markers the operator
has not acknowledged; resolution is always operator-initiated. §5 summary:
| Marker | Accept to | Reject to |
|---|---|---|
🤖[H] | empty | same |
🤖<X>[H] | X | same |
🤖{R} | R | empty |
🤖[H]{R} / 🤖{R}[H] | empty | same |
🤖~D~ | empty (deletion applied) | D |
🤖~D~{N} | N | D |
🤖~D~[N] | N | D |
longer []{} chains | empty (chain discarded, surrounding text untouched) | same |
<quoted text> reference is present: the instruction targets exactly
that text. Use it as the scope.~deleted text~ reference is present: the instruction targets
exactly that text — substitution or deletion per §5.[instruction] references something else —
a different section, a module name, the overall tone, the whole document —
apply it to that scope instead.🤖[fix this typo] → fix the preceding text🤖<foo_bar>[rename to foo_baz] → rename that exact identifier🤖~deprecated paragraph~[new paragraph text] → substitute paragraph🤖[no, module_x doesn't call module_y] → find and correct that factual claim wherever it appears🤖[the overall tone is too cheeky, we should be more serious] → adjust tone across the document{question} to the marker.