Agent skill

Index Status

by adamthewilliam in adamthewilliam/grepika

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…

MITAuto-check passedDevelopment

Install Index Status

skills CLI
$ npx skills add adamthewilliam/grepika --skill index-status -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install adamthewilliam/grepika index-status --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/adamthewilliam/grepika.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/grepika/skills/index-status .claude/skills/index-status && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
index-status
GitHub stars
138
Token cost
~696 tokens
SKILL.md length
200 words
Files
2 (incl. references)
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 3 steps: Get detailed index statistics → Verify directory coverage → Diagnose issues (if any found)
  • Asks to check index status
  • SKILL.md covers Input, Pre-check, Status Check Workflow and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Index Status is an agent skill from adamthewilliam/grepika. 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.

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/troubleshooting.md`). Compatibility notes: Requires grepika MCP server.

It sits in Development. It works with Model Context Protocol. The licence is MIT.

When your agent uses it

  • Asks to check index status
  • Is the index healthy
  • Index diagnostics
  • Search index health

Example prompts

  • “check index status”
  • “is the index healthy”
  • “index diagnostics”
  • “/index-status”

Requirements

  • Compatibility (from SKILL.md): Requires grepika MCP server.
  • Pre-approved tools (allowed-tools): mcp__grepika__stats, mcp__grepika__toc, mcp__grepika__add_workspace

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Get detailed index statistics
  2. Verify directory coverage
  3. Diagnose issues (if any found)

What it can do on your machine

Read from SKILL.md and the folder at commit f035a18. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • mcp__grepika__stats
    • mcp__grepika__toc
    • mcp__grepika__add_workspace

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires grepika MCP server.

    From compatibility in the SKILL.md frontmatter.

Context cost

Index Status loads about 696 tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 55 tokens; SKILL.md has 200 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~696
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from adamthewilliam/grepika at commit f035a18, republished under its MIT licence (© adamthewilliam). 200 words, ~696 tokens.

Download SKILL.mdSave it as .claude/skills/index-status/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
index-status
description
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.
allowed-tools
mcp__grepika__stats, mcp__grepika__toc, mcp__grepika__add_workspace
compatibility
Requires grepika MCP server.
version
1.1.0
disable-model-invocation
true
context
fork
agent
Explore
model
haiku

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

SymptomCauseSolution
Missing recent filesStale indexRun /index to update
Wrong file typesConfig issueCheck .gitignore patterns
Empty resultsIndex corruptionRun /index to force full rebuild
Slow searchesLarge indexCheck 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

© adamthewilliam, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/grepika/skills/index-status of adamthewilliam/grepika.

  • SKILL.md
  • references/troubleshooting.md

Open the folder on GitHubat commit f035a18

Compare with similar skills

Index Status next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Index Status compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Index Status this skilladamthewilliam/grepika138—~696Automated safety check: PassMIT
Debugging Executionsn8n-io/n8n207k—~2.6kAutomated safety check: PassCustom licence
ast-grep Structural Searchcode-yeongyu/oh-my-openagent70k—~3.3kAutomated safety check: PassMIT
Analyze Logsactivepieces/activepieces25k1 repos~1.6kAutomated safety check: PassMIT
ReleasePrefectHQ/fastmcp28k—~2.9kAutomated safety check: PassApache-2.0
Claude Code Skillcodeaashu/claude-code3.4k1 repos~2.7kAutomated safety check: PassProprietary

Similar skills

  • Official

    Debug failed or wrong-output workflow executions using executions tools.

    207k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • ast-grep Structural Search

    code-yeongyu/oh-my-openagent

    Searches and rewrites code by syntax-tree shape across 25 languages with ast-grep, for codemods, structural queries and YAML lint rules, using a Python wrapper script.

    70k GitHub stars~3.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Analyze Logs

    activepieces/activepieces

    Analyze application logs from the .evlog/logs/ directory. An agent skill from activepieces/activepieces.

    25k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Release

    PrefectHQ/fastmcp

    Cut a FastMCP release end to end. An agent skill from PrefectHQ/fastmcp.

    28k GitHub stars~2.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Claude Code Skill

    codeaashu/claude-code

    Development conventions and architecture guide for the Claude Code CLI repository.

    3.4k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed
  • Run Nx generators with prioritization for workspace-plugin generators.

    29k GitHub starsUsed in 2 repos~592 tokens
    DevelopmentAuto-check: notes

More from adamthewilliam/grepika

All 9 skills in this repo
  • Impact

    adamthewilliam/grepika

    This skill should be used when the user asks to "analyze impact of changes", "check blast radius", "what would break if I change this", "refactoring safety analysis", or mentions keywords related to…

    138 GitHub stars~794 tokensUpdated 1 mo ago
    Auto-check passed
  • Investigate

    adamthewilliam/grepika

    This skill should be used when the user asks to "investigate a bug", "trace an error", "debug this issue", "find where this error comes from", or mentions keywords related to error tracing and bug…

    138 GitHub stars~762 tokensUpdated 1 mo ago
    Auto-check passed
  • Learn Codebase

    adamthewilliam/grepika

    This skill should be used when the user asks to "learn this codebase", "give me a codebase overview", "onboard me to this project", "explain the architecture", or mentions keywords related to…

    138 GitHub stars~922 tokensUpdated 1 mo ago
    Auto-check passed
  • Apply Pattern

    adamthewilliam/grepika

    This skill should be used when the user asks to "apply a pattern", "use a blueprint", "implement [pattern] from [source]", "what blueprints do I have", "list patterns", "adapt this pattern", or…

    138 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check: notes
  • Architecture

    adamthewilliam/grepika

    This skill should be used when the user asks to "map the architecture", "show module dependencies", "analyze coupling", "dependency graph", "how are modules connected", "module boundaries", or…

    138 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Diff Files

    adamthewilliam/grepika

    This skill should be used when the user asks to "compare files", "diff these files", "what changed between", "show differences between", "compare versions", or mentions keywords related to file…

    138 GitHub stars~819 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Index Status

What does Index Status do?

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 Status is an agent skill from adamthewilliam/grepika. 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.

When should I use Index Status?

Index Status fits situations like: asks to check index status; is the index healthy; index diagnostics; search index health.

How do I install Index Status in Claude Code?

Run `npx skills add adamthewilliam/grepika --skill index-status -a claude-code`. Or copy the skill folder (plugins/grepika/skills/index-status in adamthewilliam/grepika) into .claude/skills/index-status in your project. Claude Code loads it when a task matches its description.

How do I install Index Status in Codex?

Run `npx skills add adamthewilliam/grepika --skill index-status -a codex`. Or copy the skill folder (plugins/grepika/skills/index-status in adamthewilliam/grepika) into .agents/skills/index-status in your project. Codex loads it when a task matches its description.

Can I use Index Status in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add adamthewilliam/grepika --skill index-status -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/index-status, .gemini/skills/index-status, .github/skills/index-status and .opencode/skills/index-status in your project.

What does Index Status need to run?

SKILL.md names no scripts, command-line tools or credentials: Index Status is instructions for the agent only. Its frontmatter pre-approves these tools: mcp__grepika__stats, mcp__grepika__toc, mcp__grepika__add_workspace. Compatibility (from SKILL.md): Requires grepika MCP server..

Does Index Status access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Index Status safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Index Status use?

Index Status is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Index Status use?

About 696 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 957 tokens, read only when the agent opens those files.

What are the alternatives to Index Status?

Skills that share tags, products or a category with Index Status: Debugging Executions (n8n-io/n8n, 207k stars), ast-grep Structural Search (code-yeongyu/oh-my-openagent, 70k stars), Analyze Logs (activepieces/activepieces, 25k stars) and Release (PrefectHQ/fastmcp, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Index Status?

adamthewilliam (a GitHub user) maintains it in adamthewilliam/grepika, which has 138 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on August 12, 2026.

Source: adamthewilliam/grepika on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.