mcp-index SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

mcp-index from arasz/ai-badger is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add arasz/ai-badger/mcp-index@v0.1.0

Pins v0.1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
arasz/ai-badger
Path
features/common/skills/mcp-index/SKILL.md
Versions recorded
5
Latest version
v0.1.0, committed Sep 24, 2026
First version recorded
Aug 7, 2026
Size
13,683 bytes
Repository stars
3
License
MIT

Use when MCP tool selection needs help — the agent keeps picking the wrong tool, server tool definitions are bloating the prompt, or MCP servers were just added or removed. Manages .ai-badger/mcp-tools.json: tags, intent descriptions, and the hook that recommends tools per turn.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# MCP Tool Index

## Prerequisites

The index itself is JSON — no dependency needed to read, tag, intent, or list it. PyYAML is
only needed to read a project's not-yet-migrated legacy `mcp-tools.yaml`:
```bash
python3 -m pip install pyyaml   # also in $AI_BADGER/engine/requirements.txt
```
Without it, a legacy-YAML-only project falls back to a stricter built-in parser and, if that
can't safely read the file, refuses with a hint rather than a traceback (see `migrate` below).

Manage `.ai-badger/mcp-tools.json` — a machine-readable index that maps every MCP server tool to tags (for filtering) and intent (for semantic matching). The index feeds the `ai_badger_hooks.py` plugin's `pre_llm_call` hook, which injects relevant tool recommendations into every LLM turn.

## Overview

MCP servers expose 40+ tools per server. Agents scan ALL tool definitions in the system prompt, wasting tokens and sometimes picking the wrong tool (e.g., `search_text` when `search_in_files_by_text` is faster). The index solves this by:

1. **Tagging** each tool with category labels (`[build]`, `[database, sql]`, `[diagnostic]`)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add arasz/ai-badger/mcp-index@sha256:150a84060c432ee4

The line at the top of this page pins the label v0.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fd2invtes24tdcmf.svg)](https://markdownregistry.com/a/art_fd2invtes24tdcmf)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 7, 2026 and Sep 24, 2026, about one every 12 days.

versioncommittedcommitsizeaudit
v0.1.0 latest2026-09-24 2979ce1 13,683 BA view · diff
v0.1.02026-08-14 898b578 13,640 BA view · diff
v0.1.02026-08-08 9006bf5 12,298 BA view · diff
v0.1.02026-08-07 4ef57e9 12,283 BA view · diff
v0.1.02026-08-07 013ee4d 14,649 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (13683 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

arasz/ai-badger · 3 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fd2invtes24tdcmf
GET https://markdownregistry.com/api/v1/resolve?ref=arasz/ai-badger/mcp-index
GET https://markdownregistry.com/api/v1/blob/150a84060c432ee474fbadbc3d5411925d1dd8ebfe1eb4004736aad5773c047e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from arasz/ai-badger

CLAUDE.md@.ai-badger CLAUDE.md file
arasz/ai-badger · .ai-badger/CLAUDE.md
git:20261007.5d99092 · audit A · 3 stars
ai-raccoon-memory SKILL.md skill
arasz/ai-badger · .ai-badger/skills/ai-raccoon-memory/SKILL.md · Use when a project needs a memory server — search project and shared memory first, write durable facts with source…
v0.2.0 · audit A · 3 stars
archify SKILL.md skill
arasz/ai-badger · .ai-badger/skills/archify/SKILL.md · Use when the user asks to visualize system architecture, infrastructure, cloud/security topology, technical workflows…
v2.16.0 · audit A · 3 stars
artifact-verification SKILL.md skill
arasz/ai-badger · .ai-badger/skills/artifact-verification/SKILL.md · Use when verifying changed artifacts that lack a canonical test gate — specs, docs, manifests, generated files…
v1.0.0 · audit A · 3 stars
auto-wm SKILL.md skill
arasz/ai-badger · .ai-badger/skills/auto-wm/SKILL.md · Use when the user wants Claude to auto-approve tool calls — "enable autonomic/autonomous work mode", "/auto-wm"…
v1.0.0 · audit A · 3 stars
browser-usage SKILL.md skill
arasz/ai-badger · .ai-badger/skills/browser-usage/SKILL.md · Use when interacting with web pages, running manual E2E browser tests, testing UI flows, or inspecting live web…
v1.0.0 · audit A · 3 stars
call-behaviorist SKILL.md skill
arasz/ai-badger · .ai-badger/skills/call-behaviorist/SKILL.md · Use when ai-badger's own machinery needs to be observed — "did that hook even run?", "enable debug logging", "why is…
v1.0.0 · audit A · 3 stars
code-review-checklist SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review-checklist/SKILL.md · Use when reviewing code — a PR, a diff, or freshly written changes — and you want concrete pass/fail checks rather than…
v1.0.0 · audit B · 3 stars
code-review-evidence SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review-evidence/SKILL.md · Use when reviewing code that wraps external libs/extensions/SDKs/CLIs, or QA-reviewing a test harness: verify…
v1.0.0 · audit A · 3 stars
code-review SKILL.md skill
arasz/ai-badger · .ai-badger/skills/code-review/SKILL.md · Use when performing a code review in this repository — reviewing a pull request, a branch diff, or a requested…
v1.0.0 · audit A · 3 stars
commit-reminder SKILL.md skill
arasz/ai-badger · .ai-badger/skills/commit-reminder/SKILL.md · Use when a project has accumulated uncommitted changes and nobody has said so out loud — several edits in a row with no…
v1.0.0 · audit A · 3 stars
complete-project-scope-code-review SKILL.md skill
arasz/ai-badger · .ai-badger/skills/complete-project-scope-code-review/SKILL.md · Use when the whole project — not a diff — is the review target and the result must survive being acted on: "review the…
v1.0.0 · audit A · 3 stars

Every file in arasz/ai-badger

Other files named mcp-index

mcp-index SKILL.md skill
arasz/ai-badger · .ai-badger/skills/mcp-index/SKILL.md · Use when MCP tool selection needs help — the agent keeps picking the wrong tool, server tool definitions are bloating…
v0.1.0 · audit A · 3 stars

Browse by kind, by grade A, or by owner.