# Script Manager

> Automates the registration and indexing of high-value Python scripts in the project's script library.

- Skill: `tomevault-io/script-manager` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/script-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/script-manager/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/script-manager

---


# Script Manager Skill

## 1. Trigger Conditions (When to use)

*   **Active**: When the Agent saves, creates, or moves a "permanent" or "high-value" script into `.gemini/scripts/`.
*   **Passive**: When the user explicitly asks to "index scripts" or "register this script".
*   **Negative**: Do *not* trigger for temporary, throwaway, or one-off debugging scripts unless explicitly requested.

## 2. Core Workflow
1.  **Identify**: Confirm the script is located in (or being written to) `.gemini/scripts/`.
2.  **Validate**: Ensure the script has a docstring describing its purpose.
3.  **Register**: Update `.gemini/scripts/GEMINI.md`.
    *   If the file doesn't exist, create it.
    *   Add a row to the "Registered Scripts" table.

## 3. Index Format (`.gemini/scripts/GEMINI.md`)

The index file must contain a table with the following columns:

| Script Name | Function | Usage Example | Tags |
| :--- | :--- | :--- | :--- |
| `example_script.py` | Brief description of what it does. | `python .gemini/scripts/example.py --arg` | `pdf`, `extraction` |

## 4. Instructions for Agent
*   **Consistency**: Always check existing tags and try to reuse them (e.g., `pdf`, `parsing`, `validation`).
*   **Brevity**: Keep descriptions under 15 words.
*   **Verification**: After updating the index, verify the entry is correct.

## 5. Example Interaction
**User**: "Save this code as `extract_usb_desc.py` in the scripts folder."
**Agent**: 
1.  Writes `.gemini/scripts/extract_usb_desc.py`.
2.  *Internal thought*: "This looks like a reusable tool. I should register it."
3.  Reads `.gemini/scripts/GEMINI.md`.
4.  Appends `| extract_usb_desc.py | Extracts USB descriptors from raw hex dumps. | python ... | `usb`, `parsing` |` to the table.
5.  Writes `.gemini/scripts/GEMINI.md`.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/yceachan) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->