rebuild-index

Rebuild manifest.json files by scanning artifact directories and extracting metadata from state files.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/nexus-a1/claude-skills --skill rebuild-index
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rebuild-index
Source: https://github.com/nexus-a1/claude-skills/tree/main/skills/rebuild-index
Command: npx skills add https://github.com/nexus-a1/claude-skills --skill rebuild-index

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rebuild manifest.json files for one or all artifact storage types by scanning directories and extracting metadata from state files. This helps restore missing or corrupted manifests and ensures artifact tracking stays accurate across a project.

Core Features & Use Cases

  • Back up existing manifests to allow recovery after errors.
  • Scan artifact directories and detect work, brainstorms, proposals, refactoring, product knowledge, and requirements manifests.
  • Build and write fresh manifest.json files with derived metadata like identifiers, titles, statuses, timestamps, and progress.
  • Delegate to other skills or agents for specialized artifact types (e.g., /rebuild-requirements-index for requirements or product-expert for product knowledge).

Quick Start

Run /rebuild-index all to rebuild all manifests, or target a single artifact type like /rebuild-index work to rebuild only the work manifest.

Frequently Asked Questions about rebuild-index

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

FAQPage Schema
How do I rebuild a corrupted manifest.json file from artifact directories?

To rebuild a corrupted manifest.json, you can scan your artifact directories and extract metadata directly from their state files to generate a fresh manifest. This process restores missing or corrupted tracking data and ensures accurate artifact management across your project.

What is the best way to restore missing manifest files for different artifact types?

Restoring missing manifest files is best handled by scanning directories to detect all artifact types like work, brainstorms, proposals, refactoring, and requirements. The system extracts identifiers, titles, statuses, and timestamps to write updated manifests to disk automatically.

Can I target a specific artifact type like work or proposals when rebuilding an index?

Yes, you can target a single artifact type to rebuild its index, such as specifying work or proposals, or you can choose to rebuild all artifact manifests simultaneously. This allows selective recovery without affecting other valid manifest files.

Does rebuilding manifests back up existing files before writing updates?

Yes, rebuilding manifests includes backing up existing manifest.json files before writing any updates to disk. This precaution allows you to recover previous manifest states if the rebuild process encounters errors or unexpected missing items.

How are specialized artifact types like product knowledge or requirements handled during a rebuild?

Specialized artifact types like requirements or product knowledge are handled by delegating the rebuild task to other dedicated skills or agents. This ensures accurate metadata extraction for specialized directories while maintaining overall index consistency.

Why does my artifact manifest show missing items after a directory scan?

Missing items appear in an artifact manifest when the directory scan detects artifacts but cannot extract complete metadata from their state files. The rebuild process handles missing items gracefully while writing updated manifests derived from available data.