index-refresh

Keeps your wiki's index synchronized with its actual contents by walking the directory structure, spotting orphaned pages in the log, and reconciling deletions. Produces a clean, sorted index with one-line summaries per page—no dates or metadata clutter—and records all changes in the log for audit trails.

index-refresh rebuilds your wiki's index file to match the actual directory structure and log entries.

AI-generated summary based on this skill's SKILL.md

★ 74,924 ⁮ 13,962 MIT updated 2026-07-28 by paperclipai

Install

paperclipai/paperclip/index-refresh · repository language: TypeScript

Manual (git clone) CLI (skillfed)coming soon

git clone https://github.com/paperclipai/paperclip
cp -r paperclip/packages/plugins/plugin-llm-wiki/skills/index-refresh ~/.claude/skills/index-refresh

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

How do I rebuild wiki index from directory structure?

index-refresh walks your wiki's directory structure to rebuild the index from scratch. It scans all actual pages, generates a clean sorted index with one-line summaries per page, and logs every change. This ensures your index matches reality without manual editing of page content.

What does index-refresh do when pages are deleted?

index-refresh reconciles missing or deleted wiki pages by comparing the index against actual files on disk. It spots orphaned entries in the log, removes them from the index, and records the deletion. This keeps your navigation accurate and prevents broken links.

Can index-refresh sync wiki index with actual pages automatically?

Yes. index-refresh automates wiki index updates without touching page content. It detects new pages, removes deleted ones, and maintains accurate wiki navigation and discoverability—all through directory scanning and log reconciliation, no manual intervention needed.

Does index-refresh log changes for audit purposes?

index-refresh records all index changes in the log and verifies structural integrity. Every rebuild, deletion, and sync operation is tracked, giving you an audit trail of what changed and when—useful for debugging index drift or reviewing maintenance history.

What format does index-refresh produce for the wiki index?

index-refresh generates a clean, sorted index with one-line summaries per page—no dates or metadata clutter. The output is designed for easy navigation and discoverability, keeping your wiki's index file lean and readable while staying synchronized with actual directory contents.

SKILL.md

rendered from the published skill — quoted content, verbatim

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

Read the target space's wiki/index.md as it currently stands.
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).
**Read the target space's last ~50 entries of

(truncated - see the full file via the links below)

Read as markdown · JSON record · Browse the source repository

File tree — 1 file

packages/plugins/plugin-llm-wiki/skills/index-refresh/SKILL.md

All skills by paperclipai → Best LLM wiki skills for AI agents - SkillFed →