Agent skill · operations · paperclipai
index-refresh
Use when an LLM Wiki operation issue requests an index refresh. Rebuild `wiki/index.md` from the actual wiki tree, reconcile missing/deleted entries, and log counts without editing page bodies.
Why this skill is useful
Adds a detailed workflow for maintaining and updating the wiki index, which includes specific commands and procedures not commonly known.
What it needs
About 2k tokens when loaded. Last updated 2026-08-07. 75,771 stars on the source repository.
What this skill does
Index Refresh Keep wiki/index.md accurate and scannable. The index is the maintainer's first stop for navigation — its quality determines how cheap every subsequent operation becomes. Inputs An operation issue with operationType: "index" (or the index-refresh routine title). The operation issue's target wikiId, spaceSlug, and space root. Refresh only that space unless the issue explicitly says this is a multi-space sweep. Workflow 1. Read the target space's wiki/index.md as it currently stands. 2. Walk the target space's wiki/. wiki/projects/<slug>/standup.md entries are current-state companions for durable wiki/projects/<slug>/index.md pages; index them only as links attached to the matching project entry. Walk wiki/ by category (sources/, projects/, entities/, concepts/, synthesis/, plus any custom subdirectories the wiki schema added). 3. Read the target space's last ~50 entries of wiki/log.md to spot pages that were created or substantially changed but never made it to the index. 4. Per category, produce sorted entries of the form: The summary is one factual sentence pulled from the page's first paragraph or its title. No status, no datestamps in the index — those belong in the page itself or in the log. 5. Drop entries whose page no longer exists. Note the deletion in the log: 6. Add entries for pages that exist on disk but were missing from the index. Skip wiki/log.md and wiki/index.md themselves. For standalone wiki/projects/<slug>/standup.md without a matching durable project page, add it under Projects and flag it for later durable-page distillation. 7. Write project entries editorially. The Projects section should group work by the project's concept and purpose, not by issue ids, dates, statuses, UUIDs, or source metadata. Link task identifiers only as supporting evidence. 8. Preserve custom categories. If the wiki has added e.g. wiki/papers/ or wiki/runbooks/, keep its index section. Do not collapse to the default five categories. 9. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills paperclipai/index-refresh