AgentSkillsCN

script-manager

自动完成项目脚本库中高价值 Python 脚本的注册与索引。

SKILL.md
--- frontmatter
name: script-manager
description: Automates the registration and indexing of high-value Python scripts in the project's script library.
license: Proprietary. LICENSE.txt has complete terms

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 NameFunctionUsage ExampleTags
example_script.pyBrief description of what it does.python .gemini/scripts/example.py --argpdf, 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.