archy/aiui/.claude/skills/add-tool/SKILL.md

name, description, allowed-tools

name	description	allowed-tools
add-tool	Add a new AI tool (function call) to the Claude proxy for the AI to use	Bash(*), Read, Edit, Write, Glob, Grep

Add a new tool that the AI model can call via Claude's tool_use API. The user will describe what the tool should do (e.g., "search local files", "get app status", "browse media").

Steps

1. Read the proxy: Read packages/app/server/claude-proxy.ts to understand the existing tool_use loop and SEARCH_WEB_TOOL definition.

2. Define the tool: Add a new tool definition following the Claude tool_use format:

   const NEW_TOOL = {
     name: 'tool_name',
     description: 'What this tool does...',
     input_schema: {
       type: 'object',
       properties: { ... },
       required: [...]
     }
   }
   

3. Add handler: In the tool_use loop (where search_web calls are handled), add a handler for the new tool name.

4. Implement backend: If the tool needs a new API endpoint (e.g., /api/media/scan), create a Vite plugin or add a route to the proxy.

5. Update system prompt: Add instructions in useAI.ts SYSTEM_PROMPT telling the AI when and how to use the new tool.

6. Verify: Run pnpm typecheck and test the proxy starts without errors.