loop-docs-update

A bounded workflow that compares documentation with the current code, updates one mismatched area, and checks the documentation again.

In plain words
What is it for?
Use it to find and correct outdated documentation about code behavior, interfaces, or project contracts.
Why use it?
It keeps written instructions from drifting away from how the software actually works. It stops when the docs match, no change is needed, or the same mismatch keeps returning, with approval required before edits.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/jsuvic/agent-profile/loop-docs-update
Any agent
npx skills add jsuvic/agent-profile --skill loop-docs-update
Clone the repo
git clone --depth 1 https://github.com/jsuvic/agent-profile

Made for: Claude Code, Codex.

Per session 40 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 343 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00040 $0.00343
Opus 5 $0.00020 $0.00171
Sonnet 5 $0.00008 $0.00069
Haiku 4.5 $0.00004 $0.00034

Measured 2d ago against content hash cc12d926340c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

loop-docs-update scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

fixtures/automation-pack-enabled/expected/.agents/skills/loop-docs-update/SKILL.md · 41 lines

What it actually says

Loop: Documentation Update

Bring documentation back in sync with the code through a bounded number of iterations. Each iteration scans for drift, updates one area, and re-verifies against the source.

Loop Steps

  1. Scan the docs for statements that no longer match the current code or contracts.
  2. Update one drifted area to match the code, keeping the change focused.
  3. Re-verify the updated docs against the source and note any remaining drift.

Max Iterations

The loop runs at most 3 iterations. When it reaches 3 iterations without meeting a stop condition, it stops unconditionally and reports the unfinished state and the outstanding work; it never raises the bound to keep going.

Stop Conditions

Stop the loop as soon as any of these holds:

  • The relevant tests and checks are green.
  • An iteration produces no diff.
  • The same failure repeats identically across two consecutive iterations.

Approval Gate

  • Get explicit human approval before any write, commit, or destructive step in each iteration.
  • The loop never self-approves, never continues past the iteration bound, and never runs destructive commands on its own authority.
  • Pause and surface the state whenever approval is missing.

Safety

  • Do not upload source code.
  • Do not read or print secrets.
  • APC does not run this loop; a human or agent follows these instructions and remains in control.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 41 lines · 40 tokens per session scan A cc12d926340c

Subscribe to this mod's changes

loop-docs-update is a skill published in the GitHub repository jsuvic/agent-profile (3 stars, last pushed 9d ago), licensed Apache-2.0. It adds 40 tokens to every session and 343 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

goutoujunshi

恋爱军师与情绪支持 skill。用于心动、暧昧、追求、聊天记录或截图分析、约会、关系确认、多人选择、冲突、冷淡、投入失衡、分手、复合、出轨、婚姻或家庭问题;也用于分析关系信号、设计主动推进或退出策略、润色可直接发送的话术,以及把冷读、自然流、Blueprint、Mystery 等经典社交体系转译成真实、互惠、可退出的沟通能力。支持分析ChatLab已有数据和经同意可撤销的长期关系档案,不负责导出聊天软件数据。首次使用时为用户及一个或多个目标对象建立包含 MBTI、主观综合评分和关系背景的档案。.

shengjidaguai-china/goutoujunshi · 175 tokens

gpt-image

Use this skill whenever a user asks to generate, create, draw, render, or edit images with GPT Image 2 / gpt-image-2, text-to-image, reference-image editing, inpainting, posters, typography, Chinese text, UI mockups, diagrams, or gallery prompts. Analyze the user's prompt, search the bundled Reference Gallery/craft…

wuyoscar/GPT-Image2-Skill · 120 tokens

pixel2motion

Turn a raster logo (PNG/JPG/WebP/screenshot) into a clean minimal SVG with edge smoothness as the primary hard gate and IoU optimized as high as reasonably possible without a fixed global threshold, then into a choreographed logo animation delivered as standalone JS-rendered HTML, applying Disney's 12 animation…

nolangz/pixel2motion · 163 tokens

beautify-github-readme

Redesign GitHub README homepages or create project-native pure SVG, hybrid SVG-composed PNG/WebP, and opt-in animated GIF assets. Use when a user asks to beautify, redesign, rebrand, visually upgrade, simplify, or audit a GitHub README; create only a hero, section headers, diagrams, badges, motion graphics, showcase…

oil-oil/beautify-github-readme · 143 tokens

submit-product-directories-v2-quality

SPD V2 Quality. Discover, deeply qualify, submit, and audit truthful product listings across Windows, macOS, and Linux-capable environments on relevant product, software, startup, app, and AI-tool directories with audience-value screening, SEO quality gates, action-level authorization, privacy controls, and…

flaqai/backlink_skills · 125 tokens

codex-autoresearch

Run autonomous, measurable experiments in a Git repository: change one hypothesis, verify a numeric metric, keep improvements, and revert failures. Use when the user wants Codex to keep iterating toward a numeric target in the foreground or as a detached background run. Do not use for ordinary one-shot coding…

leo-lilinxiao/codex-autoresearch · 80 tokens