index-refresh

Rebuilds wiki index files with one-line summaries reconciled against actual wiki contents.

Updated Jul 14, 2026
One-click install
npx skills add https://github.com/Douglas-v/strategic-ai-paperclip-lab --skill index-refresh-douglas-v
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: index-refresh
Source: https://github.com/Douglas-v/strategic-ai-paperclip-lab/tree/main/paperclip/packages/plugins/plugin-llm-wiki/skills/index-refresh
Command: npx skills add https://github.com/Douglas-v/strategic-ai-paperclip-lab --skill index-refresh-douglas-v

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Wiki index pages drift out of sync with the actual wiki contents over time — pages get created without being indexed, deleted pages leave dangling entries, and summaries become stale. This Skill reconciles wiki/index.md with the real state of the wiki so navigation stays accurate and cheap. ## Core Features & Use Cases - Index Reconciliation: Walks the wiki directory tree, adds missing pages, drops entries for deleted pages, and logs every change with counts. - One-Line Summaries: Generates a factual single-sentence summary per entry pulled from each page's first paragraph or title, with no statuses or datestamps. - Project Standup Linking: Attaches standup.md entries as links on their matching durable project pages and flags orphaned standups for later distillation. - Use Case: During the hourly index-refresh routine, an operation issue arrives with a target wikiId and spaceSlug; the Skill rebuilds that space's index, preserves custom categories like papers/ or runbooks/, and appends an audit log entry even when nothing changed. ## Quick Start Run the index-refresh routine on the wiki space referenced by this operation issue and reconcile its index with the actual pages on disk.

Frequently Asked Questions about index-refresh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep a wiki index in sync with actual pages?

Run an index-refresh pass that walks the wiki directory, compares it against the existing index, adds entries for pages missing from the index, and removes entries whose pages no longer exist. Log every addition and removal so future audits can trace the changes.

How to write good one-line summaries for a wiki index?

Pull one factual sentence from the page's first paragraph or its title, written in present tense. Do not include statuses, dates, or metadata in the index line — those belong in the page body or the log.

Does index refresh modify wiki page content?

No. The refresh only rewrites the index file and appends entries to the log. Page bodies and raw files are never modified; content problems like contradictions or broken links are deferred to a separate lint pass.

What happens to custom wiki categories during index refresh?

Custom categories such as papers or runbooks directories are preserved as their own index sections. The refresh does not collapse them into the default categories of sources, projects, entities, concepts, and synthesis.

Why log an index-refresh run when nothing changed?

Writing a log entry with zero additions and removals proves the reconciliation ran and the index was verified accurate. Without it, future audits cannot distinguish a clean index from a skipped run.