refresh-agent-docs — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited refresh-agent-docs (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Keeps .agents/docs/ honest. Each DOC.md and <SUBTOPIC>.md carries YAML frontmatter (last_verified, optional upstream_commit, sources); this skill re-verifies, applies fixes, and bumps the date.
Pair with gather-agent-docs (seed entries, deepen on request) and use-agent-docs (read them).
INDEX.md — every *.md under each topic's directory.*.md in those directories.INDEX.md date to the new oldest..agents/docs/INDEX.md does not exist — propose gather-agent-docs instead.Before re-fetching upstream content, try the cheap paths in order. The richer the page's frontmatter, the more refreshes short-circuit.
upstream_commit is set and matches upstream HEAD (e.g. via the repo URL's HEAD SHA), the page is verified by definition. Bump last_verified, mark unchanged, done.sources.changelog (or sources.release) and filter entries dated after last_verified. None matching → bump last_verified, mark unchanged, done._Source: …_ page.upstream_commit, no changelog, smart paths inconclusive → re-fetch the topic's nav source and walk every captured T2 snippet.For each *.md in scope (DOC.md plus any subtopic files):
last_verified to today and refresh upstream_commit when applicable. After all of a topic's files are processed, set INDEX.md's [YYYY-MM-DD] for that topic — and INDEX.md's own last_verified frontmatter — to the oldest last_verified among that topic's files.last_verified is more than 6 months old after this run, insert at the top of the body (just below the frontmatter): > ⚠ Stale (verified YYYY-MM-DD). Confirm captured details upstream before acting. Remove the banner automatically on the next successful re-verify.Summarize each topic. With subtopic files, list each *.md (DOC + subtopics) on its own line under the topic, with its own outcome:
unchanged — verified (smart-path or full); only the date moved.links repaired — at least one URL in the map was replaced (always note the old → new swap).links dropped — a URL had no live equivalent; gap noted in the file.map extended — new upstream pages folded in.map trimmed — entries removed because upstream removed them.snippet edits — captured T2 snippet changed.structural changes — concepts, surfaces, or grouping shifted.stale banner added — could not re-verify this session; banner inserted.needs human review — change was ambiguous or upstream looked unstable.gather-agent-docs: every captured detail must come from upstream just fetched in this session, or a command run in this session. Don't carry stale facts forward just because they were already there. Never paraphrase, infer, or auto-complete from training memory.gather-agent-docs's job.gather-agent-docs deepen territory; this skill only updates snippets that already exist..agents/docs/INDEX.md — use gather-agent-docs first.gather-agent-docs.gather-agent-docs — seeds and extends .agents/docs/; deepens with captured snippets on request.use-agent-docs — reads .agents/docs/ before web research; surfaces staleness that triggers this skill.~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.