Loop docs update

Skill jsuvic/agent-profile/fixtures/tabnine-workflow-skills/expected/.agents/skills/loop-docs-update

Use to run a bounded documentation drift scan, update, and re-verify loop that stops when docs match the code, on no diff, or on a repeated identical mismatch.From its SKILL.md

Install

npx -y skills add jsuvic/agent-profile --skill loop-docs-update

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.6 KB, 297 tokens by cl100k_base, as published. Nobody here has run it

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

Scan the docs for statements that no longer match the current code or contracts.
Update one drifted area to match the code, keeping the change focused.
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.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Gives 0 of the 12 instructions most docs writing skills give in 297 tokens

Counted across 1,637 of the 3,044 authors here whose files we hold, read 2026-08-07

Announce the skill at startin 54 of 1637, across 26 files
Convert legacy doc files before editingin 45 of 1637, across 7 files
Predict questions readers might askin 42 of 1637, across 4 files
Generate clarifying questions for initial contextin 42 of 1637, across 3 files
Create document scaffold with placeholder textin 42 of 1637, across 3 files
Brainstorm content options for each sectionin 42 of 1637, across 3 files
Test the document with a fresh context-less instancein 42 of 1637, across 3 files
Include exact file paths in every taskin 42 of 1637, across 15 files
Ask interview questions one at a timein 42 of 1637, across 27 files
Apply surgical edits during refinementin 41 of 1637, across 2 files
Offer structured workflow or freeformin 40 of 1637, across 1 file
Ask for document meta-contextin 40 of 1637, across 2 files

Said here and by no other author read

scan docs for statements mismatching code
update one drifted area to match code
re-verify updated docs against source
run at most three loop iterations
stop when relevant tests and checks are green
stop when an iteration produces no diff

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.