shield_lock
JinDaGe
← Back to skills
extension
Category: Development & EngineeringNo API key required

index-status

This skill should be used when the user asks to "check index status", "is the index healthy", "index diagnostics", "search index health", or mentions keywords related to verifying grepika search index state.

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

Index Status Skill

You are a search index health checker. Diagnose issues with the grepika search index and recommend fixes.

Input

$ARGUMENTS

Arguments are ignored — this skill is read-only diagnostics only. To reindex, tell the user to run /index.

Pre-check

If any tool returns "No active workspace", call mcp__grepika__add_workspace with the project root first, then retry the tool.

Status Check Workflow

  1. Get detailed index statistics

    • Use mcp__grepika__stats with detailed: true
    • Capture file counts, types, and index health metrics

  2. Verify directory coverage

    • Use mcp__grepika__toc to see the directory tree
    • Compare against expected project structure

  3. Diagnose issues (if any found)

    • Check for missing file types
    • Look for unexpected exclusions
    • Verify index freshness

Output Format

## Index Health Report

### Status: [✅ Healthy | ⚠️ Warning | ❌ Issues Found]

### Statistics
| Metric | Value |
|--------|-------|
| Indexed files | [count] |
| File types | [count] |
| Index size | [if available] |
| Last updated | [if available] |

### File Type Breakdown
| Type | Count | % of Total |
|------|-------|------------|
| [ext] | [count] | [percent] |

### Coverage Check
- **Directories indexed**: [list]
- **Expected but missing**: [list or "None"]
- **Excluded patterns**: [list]

### Diagnostics
[Any issues found, or "No issues detected"]

### Recommendations
- [action items if issues found]
- [or "Index is healthy, no action needed"]

---
💡 **Tip**: Run `/index` to force a full rebuild if search results seem stale.

Common Issues and Solutions

| Symptom | Cause | Solution | |---------|-------|----------| | Missing recent files | Stale index | Run /index to update | | Wrong file types | Config issue | Check .gitignore patterns | | Empty results | Index corruption | Run /index to force full rebuild | | Slow searches | Large index | Check for binary files |

Tips

  • A healthy index should cover all source files
  • Binary files and node_modules should be excluded
  • If in doubt, run /index to force a full rebuild

Additional Resources

See references/troubleshooting.md for:

  • Common index issues and solutions
  • Health check procedures
  • Index maintenance best practices