query-loop-implementation SKILL.md skillA

query-loop-implementation from simbajigege/book2skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add simbajigege/book2skills/query-loop-implementation@git:20260518.cf8ab2b

Pins git:20260518.cf8ab2b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
simbajigege/book2skills
Path
skills/query-loop-implementation/SKILL.md
Versions recorded
1
Latest version
git:20260518.cf8ab2b, committed May 18, 2026
Size
5,671 bytes
Repository stars
202
License
MIT

Implement a production-ready LLM query loop / agent loop for AI applications. Use this skill whenever the user wants to add tool calling, ReAct-style reasoning-action-observation cycles, function calling loops, query engines, agent runtimes, tool_result feedback, max-turn exits, or Claude Code-like Agent Loop behavior to their own product or codebase.

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

# Query Loop Implementation

## Core Idea

Build the loop as product infrastructure, not prompt glue:

```text
ConversationManager -> QueryLoop -> ToolRuntime
```

- `ConversationManager` owns durable state: session id, messages, user settings, budget, persistence.
- `QueryLoop` owns one task turn: call model, detect tool calls, execute tools, append tool results, repeat.
- `ToolRuntime` owns registered tools: schemas, permission checks, execution, error formatting.

Use ReAct as the mental model:

```text
Thought -> Action -> Observation -> Thought -> Answer
```

Implement it as structured API traffic:

```text
model thinking/text -> tool_call -> tool_result -> next model call -> final text
```

## Implementation Workflow

1. Inspect the user's stack and current LLM call site.
   Find where messages are built, where the model is called, and whether tool/function calling is already configured.

2. Introduce a minimal query loop.
   Keep the first version narrow: one model call function, one tool registry, explicit exit conditions.

3. Normalize message shapes.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add simbajigege/book2skills/query-loop-implementation@sha256:cf6555ee5332e769

The line at the top of this page pins the label git:20260518.cf8ab2b, 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_zmkwgqqoni5bcz2k.svg)](https://markdownregistry.com/a/art_zmkwgqqoni5bcz2k)

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

Versions

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

versioncommittedcommitsizeaudit
git:20260518.cf8ab2b latest2026-05-18 cf8ab2b 5,671 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 (5671 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

simbajigege/book2skills · 202 stars · license MIT · pushed 2026-08-26 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zmkwgqqoni5bcz2k
GET https://markdownregistry.com/api/v1/resolve?ref=simbajigege/book2skills/query-loop-implementation
GET https://markdownregistry.com/api/v1/blob/cf6555ee5332e76963fc1ed2b4a105fcac2e664d816cd7fece9f355584bb945a

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 simbajigege/book2skills

agent-memory-implementation SKILL.md skill
simbajigege/book2skills · skills/agent-memory-implementation/SKILL.md · Restructures a chaotic or overgrown MEMORY.md into a clean 2-layer architecture based on how Claude Code's autoDream…
git:20260528.d45c1fe · audit A · 202 stars
agent-tool-builder SKILL.md skill
simbajigege/book2skills · skills/agent-tool-builder/SKILL.md · Define agent tools using the fail-closed design pattern — unified name/schema/security/execution in one class, with…
git:20260612.4cde403 · audit A · 202 stars
analyzing-financial-statements SKILL.md skill
simbajigege/book2skills · skills/analyzing-financial-statements/SKILL.md · Apply Xiao Xing's financial statement analysis framework from 一本书读懂财报 (Understanding Financial Reports in One Book)…
git:20260421.426ae59 · audit A · 202 stars
business-adventures-analysis-brooks SKILL.md skill
simbajigege/book2skills · skills/business-adventures-analysis-brooks/SKILL.md · Use Business Adventures for "why did this fail?", "analyze this crisis", "what pattern applies?", or "what would Brooks…
git:20260429.bf2dad1 · audit A · 202 stars
clash-cultures-investment-speculation-bogle SKILL.md skill
simbajigege/book2skills · skills/clash-cultures-investment-speculation-bogle/SKILL.md · Apply John Bogle stewardship capitalism logic to separate investing from
git:20260430.ba4df11 · audit A · 202 stars
common-sense-index-investing-bogle SKILL.md skill
simbajigege/book2skills · skills/common-sense-index-investing-bogle/SKILL.md · Apply John Bogle index investing rules for low-cost funds, asset allocation,
git:20260430.ba4df11 · audit A · 202 stars
compact-memory-implementation SKILL.md skill
simbajigege/book2skills · skills/compact-memory-implementation/SKILL.md · Developer implementation guide for adding compact memory to an Agent — covers fork agent pattern for compaction…
git:20260524.a98558f · audit A · 202 stars
contagious-viral-content-berger SKILL.md skill
simbajigege/book2skills · skills/contagious-viral-content-berger/SKILL.md · Apply Jonah Berger''s STEPPS framework. Trigger on: "why is this not spreading?", "make this campaign contagious"…
git:20260501.32e482d · audit A · 202 stars
contract-drafting-and-review-guidance-china-law SKILL.md skill
simbajigege/book2skills · skills/contract-drafting-and-review-guidance-china-law/SKILL.md · Apply China contract drafting review with San Guan Si Bu Fa. Trigger on contract review, drafting, clauses, or deal…
git:20260430.5b2ddcd · audit A · 202 stars
creating-superfans-hodak SKILL.md skill
simbajigege/book2skills · skills/creating-superfans-hodak/SKILL.md · Apply Brittany Hodak's SUPER Model for customer loyalty, referrals, word of mouth, personalization, service recovery…
git:20260429.41e55c1 · audit A · 202 stars
customers-yachts-wall-street-schwed SKILL.md skill
simbajigege/book2skills · skills/customers-yachts-wall-street-schwed/SKILL.md · Analyze Wall Street conflicts. Trigger on: "can I trust this advisor?", "is this forecast reliable?", "whose interest…
git:20260501.32e482d · audit A · 202 stars
essays-in-persuasion-keynes SKILL.md skill
simbajigege/book2skills · skills/essays-in-persuasion-keynes/SKILL.md · Apply Keynes policy reasoning. Trigger on: "will austerity work?", "inflation or deflation?", "analyze this economic…
git:20260501.32e482d · audit A · 202 stars

Every file in simbajigege/book2skills

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