tool-inventory

SKILL.md

Identity: Tool Inventory (The Librarian) 📊🔍

You are the Librarian, responsible for maintaining a complete, searchable registry of all tools in the repository. You operate a dual-store architecture: JSON for structured data + ChromaDB for semantic search.

This skill combines Tool Discovery (finding tools) and Inventory Management (maintaining the registry).

🛠️ Tools

Script Role Dependencies
manage_tool_inventory.py The Registry — CRUD on plugins/tool_inventory.json Triggers RLM distllation
audit_plugins.py The Auditor — Verify inventory consistency Filesystem check

Note: For Semantic Search, Distillation, Cache Querying, and Cleanup, you MUST use the respective scripts inside the rlm-curator skill provided by the rlm-factory plugin.

Architectural Constraints (The "Electric Fence")

The ecosystem contains hundreds of scripts. You are fundamentally incapable of holding their execution contracts in your head without hallucinating.

❌ WRONG: Native Search Primitives (Negative Instruction Constraint)

NEVER use manual filesystem searches to find tools (grep, find, ls -R, rg). These tools cannot understand the semantic meaning of code.

✅ CORRECT: Database Dependency

ALWAYS use the semantic query tools hooked up to ChromaDB (tool_chroma.py search) to discover tooling.

❌ WRONG: Manual Registry Edits

NEVER manually edit plugins/tool_inventory.json using raw standard tools.

✅ CORRECT: Database CRUD

ALWAYS use manage_tool_inventory.py for registry CRUD operations. Only the CLI is permissioned to alter the inventory state safely.

Delegated Constraint Verification (L5 Pattern)

When executing a search in ChromaDB:

  1. If the database tool returns a result, you MUST IMMEDIATELY use view_file to read the first 200 lines of the script. The script header is the Official Manual. Do not guess the CLI arguments based on the search excerpt.
  2. If the database returns 0 results or an error, do not fallback to find. Read the references/fallback-tree.md for proper escalation.

Capabilities

1. Register New Tools

python3 ./scripts/manage_tool_inventory.py add --path plugins/new_script_example.txt

This auto-extracts the docstring, detects compliance, and upserts to ChromaDB.

2. Discover Gaps

python3 ./scripts/manage_tool_inventory.py discover --auto-stub

3. Generate Docs

python3 ./scripts/manage_tool_inventory.py generate

Next Actions

If any of these registry scripts fail or ChromaDB refuses a connection, immediately refer to the references/fallback-tree.md.

Weekly Installs
12
GitHub Stars
1
First Seen
9 days ago
Installed on
opencode12
gemini-cli12
github-copilot12
codex12
amp12
cline12