[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M752P7SWN8QEVKH5TFX8GJED":3,"skill-same:01M752P7SWN8QEVKH5TFX8GJED":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":31,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":34,"ownerDescription":35,"updatedAt":36,"install":37,"resources":50},"01M752P7SWN8QEVKH5TFX8GJED","tool-discovery",null,"Find and manage available tools. Learn how to list user-created tools, search by criteria, categorize by risk level, and understand tool status states.","review-bench\u002Ftallclub_matimo","review-bench","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F286778065?v=4","01M7517F9NTEPDZDAXJBR30FWT","ReviewBench","01M752MJ9AMPM35VHCA4HV09DY",0,"MIT","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Ftallclub_matimo\u002Fblob\u002Fmain\u002Ftypescript\u002Fpackages\u002Fcore\u002Fskills\u002Ftool-discovery\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: tool-discovery\ndescription: \"Find and manage available tools. Learn how to list user-created tools, search by criteria, categorize by risk level, and understand tool status states.\"\nmetadata:\n  category: \"Tool Management\"\n  difficulty: \"beginner\"\n  apply-to: \"matimo_list_user_tools matimo_list_skills matimo_get_tool_status\"\n---\n\n# Tool Discovery: Finding and Managing Tools\n\nThis skill teaches you how to **discover, search, and manage** Matimo tools that are available in your system.\n\n## Overview: Tool Sources\n\nThree sources of tools:\n\n1. **Core\u002FBuilt-in Tools** — Shipped with Matimo SDK\n   - `matimo_create_tool`, `matimo_validate_tool`, `matimo_doctor`, etc.\n   - Read-only, always available\n   - Used by agents to manage tool lifecycle\n\n2. **Provider Tools** — Application-specific tools from packages\n   - Slack tools, GitHub tools, AWS tools, etc.\n   - Defined in `packages\u002F{provider}\u002Ftools\u002F`\n   - Available after initialization with `toolPaths`\n\n3. **User-Created Tools** — Dynamically created by agents\n   - Stored in `target_dir` (usually temp directory)\n   - Status: `draft`, `approved`, `rejected`\n   - Discovered via `matimo_list_user_tools`\n\n---\n\n## Meta-Tool: matimo_list_user_tools\n\nLists all tools created by agents in a specific directory.\n\n```\nInput:  { target_dir: \"\u002Fpath\u002Fto\u002Ftools\" }\nOutput: { tools: [...] status: \"success\" }\n```\n\n### Basic Usage\n\n```\nCall: matimo_list_user_tools(target_dir=\"\u002Ftmp\u002Fmy-tools\")\n\nResponse:\n{\n  \"tools\": [\n    {\n      \"name\": \"weather_fetch\",\n      \"version\": \"1.0.0\",\n      \"description\": \"Get current weather for a city\",\n      \"status\": \"approved\",\n      \"riskLevel\": \"LOW\",\n      \"createdAt\": \"2026-03-17T10:30:00Z\",\n      \"executionType\": \"http\",\n      \"requiresApproval\": false\n    },\n    {\n      \"name\": \"file_reader\",\n      \"version\": \"1.0.0\",\n      \"description\": \"Read files from filesystem\",\n      \"status\": \"rejected\",\n      \"riskLevel\": \"CRITICAL\",\n      \"reason\": \"Command tools are blocked by policy\",\n      \"createdAt\": \"2026-03-17T10:31:00Z\",\n      \"executionType\": \"command\",\n      \"requiresApproval\": true\n    }\n  ],\n  \"summary\": {\n    \"total\": 2,\n    \"approved\": 1,\n    \"rejected\": 1,\n    \"draft\": 0\n  }\n}\n```\n\n---\n\n## Understanding Tool Status\n\n### Status: `approved`\n\nTool has been validated and approved by human operator. Ready to use.\n\n```\nIndicators:\n- ✅ Created with matimo_create_tool\n- ✅ Passed matimo_doctor validation\n- ✅ Human approved via matimo_review\n- ✅ Registry reloaded via matimo_reload_tools\n- ✅ Executable via matimo.execute()\n```\n\n**Example in response:**\n```json\n{\n  \"name\": \"weather_fetch\",\n  \"status\": \"approved\",\n  \"riskLevel\": \"LOW\",\n  \"message\": \"Ready for execution\"\n}\n```\n\n### Status: `draft`\n\nTool created but not yet approved. Cannot be executed.\n\n```\nIndicators:\n- ✅ Created with matimo_create_tool\n- ✅ Passed validation\n- ⏸️ Waiting for human approval via matimo_review\n- ❌ NOT executable\n```\n\n**Example in response:**\n```json\n{\n  \"name\": \"todo_create\",\n  \"status\": \"draft\",\n  \"riskLevel\": \"MEDIUM\",\n  \"message\": \"Awaiting human approval\"\n}\n```\n\n### Status: `rejected`\n\nTool failed policy validation or human rejected it. Cannot be used.\n\n```\nIndicators:\n- ❌ Failed policy check (e.g., command blocked)\n- OR: ❌ Human rejected after review\n- ❌ NOT executable\n- ❌ Marked as rejected\n```\n\n**Example in response:**\n```json\n{\n  \"name\": \"file_reader\",\n  \"status\": \"rejected\",\n  \"riskLevel\": \"CRITICAL\",\n  \"reason\": \"Command tools are blocked by policy. Use HTTP endpoints instead.\"\n}\n```\n\n---\n\n## Understanding Risk Levels\n\nRisk level indicates **potential impact** if the tool is misused or exploited:\n\n### Risk Level: `LOW`\n\n**When:** Read-only HTTP GET to public APIs\n\n```yaml\nexecution:\n  type: http\n  method: GET\n  url: \"https:\u002F\u002Fapi.github.com\u002Fusers\u002F{username}\"\n```\n\n**Why LOW:**\n- ✅ No data modification\n- ✅ Public API (no secrets)\n- ✅ Limited impact even if exposed\n- ✅ Auto-approved, no human approval needed\n\n---\n\n### Risk Level: `MEDIUM`\n\n**When:** Data modification via HTTP POST\u002FPUT\n\n```yaml\nexecution:\n  type: http\n  method: POST\n  url: \"https:\u002F\u002Fapi.slack.com\u002Fapi\u002Fchat.postMessage\"\n```\n\n**Why MEDIUM:**\n- ⚠️ Can modify data (send messages, create issues)\n- ⚠️ Requires credentials (API key)\n- ⚠️ Requires human review before execution\n- ✅ Policy allows it (HTTP only)\n\n---\n\n### Risk Level: `HIGH`\n\n**When:** Access to sensitive APIs or complex operations\n\n```yaml\nexecution:\n  type: http\n  method: DELETE\n  url: \"https:\u002F\u002Fapi.github.com\u002Frepos\u002F{owner}\u002F{repo}\"\n```\n\n**Why HIGH:**\n- ⚠️ Destructive operation (deletion)\n- ⚠️ Affects multiple users\n- ⚠️ Hard to undo\n- ✅ Policy allows it (HTTP only)\n- ⚠️ Requires careful human review\n\n---\n\n### Risk Level: `CRITICAL`\n\n**When:** Shell commands, code execution, or policy violations\n\n```yaml\nexecution:\n  type: command\n  command: bash\n  args: [\"-c\", \"{user_command}\"]\n```\n\n**Why CRITICAL:**\n- ❌ Full system access\n- ❌ Can read\u002Fwrite files, modify system\n- ❌ Cannot be restricted\n- ❌ Policy blocks (allowCommandTools: false)\n- ❌ Always rejected\n\n---\n\n## Query Examples\n\n### Example 1: List All Tools in a Directory\n\n```\nCall: matimo_list_user_tools(target_dir=\"\u002Ftmp\u002Fmatimo-tools\")\n\nWhat you'll see:\n- All tools created in that directory\n- Their current status (approved\u002Fdraft\u002Frejected)\n- Risk level and reason (if rejected)\n- Execution type and requirements\n```\n\n### Example 2: Check Which Tools Are Approved\n\nAgent logic:\n```\nCall: matimo_list_user_tools(target_dir=\"\u002Ftmp\u002Fmatimo-tools\")\nFilter: tools where status === \"approved\"\nResult: Only ready-to-use tools\n```\n\n**Use case:** \"What tools can I use right now?\"\n\n### Example 3: Check Why a Tool Was Rejected\n\nAgent logic:\n```\nCall: matimo_list_user_tools(target_dir=\"\u002Ftmp\u002Fmatimo-tools\")\nFind: tool named \"file_reader\"\nCheck: status === \"rejected\"\nRead: tool.reason\nOutput: \"Command tools are blocked by policy\"\n```\n\n**Use case:** \"Why doesn't file_reader work?\"\n\n### Example 4: Understand Tool Capabilities\n\nAgent logic:\n```\nCall: matimo_list_user_tools(target_dir=\"\u002Ftmp\u002Fmatimo-tools\")\nFor each tool:\n  - executionType: \"http\" or \"command\" or \"function\"\n  - riskLevel: \"LOW\" to \"CRITICAL\"\n  - requiresApproval: true\u002Ffalse\n\nDecision: Which tools match my goal?\n```\n\n**Use case:** \"What operations can I do?\"\n\n---\n\n## Complete Tool Information\n\nWhen `matimo_list_user_tools` returns a tool, it includes:\n\n```json\n{\n  \"name\": \"github_create_issue\",         \u002F\u002F Unique identifier\n  \"version\": \"1.0.0\",                    \u002F\u002F Semantic version\n  \"description\": \"Create an issue...\",   \u002F\u002F What it does\n  \"status\": \"approved\",                  \u002F\u002F approved | draft | rejected\n  \"riskLevel\": \"MEDIUM\",                 \u002F\u002F LOW | MEDIUM | HIGH | CRITICAL\n  \"createdAt\": \"2026-03-17T10:30:00Z\",   \u002F\u002F When created\n  \"executionType\": \"http\",               \u002F\u002F http | command | function\n  \"requiresApproval\": false,             \u002F\u002F approval needed for execution?\n  \"reason\": null,                        \u002F\u002F If rejected, why\n  \"approvedBy\": \"human-operator\",        \u002F\u002F Who approved it\n  \"approvedAt\": \"2026-03-17T10:31:00Z\",  \u002F\u002F When approved\n  \"parameters\": {                        \u002F\u002F Input parameters\n    \"owner\": { \"type\": \"string\", \"required\": true },\n    \"repo\": { \"type\": \"string\", \"required\": true },\n    \"title\": { \"type\": \"string\", \"required\": true }\n  }\n}\n```\n\n---\n\n## Common Discovery Patterns\n\n### Pattern 1: Report on All Tools\n\nAgent goal: \"What tools has the system created?\"\n\n```\nCall: matimo_list_user_tools(target_dir=\u003CprovidedDir>)\nOutput each tool:\n  - Name and description\n  - Status (✅ approved or ❌ rejected)\n  - Risk level\n\nSummary: \"System has 3 tools: 2 approved, 1 rejected\"\n```\n\n### Pattern 2: Find Tools Ready to Use\n\nAgent goal: \"What can I execute right now?\"\n\n```\nCall: matimo_list_user_tools(target_dir=\u003Cdir>)\nFilter: status === \"approved\" AND riskLevel !== \"CRITICAL\"\nThen: User can safely call matimo.execute(toolName, params)\n```\n\n### Pattern 3: Understand Why Tool Was Rejected\n\nAgent goal: \"Can I fix the rejected file_reader tool?\"\n\n```\nCall: matimo_list_user_tools(target_dir=\u003Cdir>)\nFind: \"file_reader\"\nRead: reason = \"Command tools are blocked by policy\"\nLearn: \"I can't fix this; policy is immutable. I need HTTP instead.\"\n```\n\n### Pattern 4: Summarize Safety Status\n\nAgent goal: \"Is the tool environment safe?\"\n\n```\nCall: matimo_list_user_tools(target_dir=\u003Cdir>)\nCount: CRITICAL-level tools\nIf count === 0:\n  Result: ✅ \"Safe—no critical-risk tools\"\nIf count > 0:\n  Result: ⚠️ \"Unsafe—{count} high-risk tools present\"\n```\n\n---\n\n## Meta-Tool: matimo_list_skills\n\nLists available **skills** (domain knowledge files) in the system.\n\n```\nCall: matimo_list_skills()\n\nResponse:\n{\n  \"skills\": [\n    {\n      \"name\": \"tool-creation\",\n      \"description\": \"Create tools for the Matimo SDK...\",\n      \"category\": \"Tool Development\",\n      \"difficulty\": \"intermediate\"\n    },\n    {\n      \"name\": \"meta-tools-lifecycle\",\n      \"description\": \"Master the tool lifecycle workflow...\",\n      \"category\": \"Tool Lifecycle\",\n      \"difficulty\": \"advanced\"\n    },\n    {\n      \"name\": \"policy-validation\",\n      \"description\": \"Security rules and enforcement...\",\n      \"category\": \"Security & Policy\",\n      \"difficulty\": \"intermediate\"\n    }\n  ],\n  \"summary\": {\n    \"total\": 3,\n    \"byCategory\": {\n      \"Tool Development\": 1,\n      \"Tool Lifecycle\": 1,\n      \"Security & Policy\": 1\n    }\n  }\n}\n```\n\n### When to Use Skills\n\n```\nAgent: \"I need to learn how to create a tool\"\nAgent: matimo_list_skills()\nAgent: \"I found 'tool-creation' skill. Let me apply it to my task.\"\nResult: Agent generates better YAML with complete structure\n```\n\n---\n\n## Meta-Tool: matimo_get_tool_status\n\nGets detailed status of a specific tool.\n\n```\nCall: matimo_get_tool_status(toolName=\"weather_fetch\", target_dir=\"\u002Ftmp\u002Ftools\")\n\nResponse:\n{\n  \"name\": \"weather_fetch\",\n  \"status\": \"approved\",\n  \"details\": {\n    \"createdAt\": \"2026-03-17T10:30:00Z\",\n    \"approvedAt\": \"2026-03-17T10:31:00Z\",\n    \"approvedBy\": \"human-operator\",\n    \"integrityHash\": \"sha256:abc123...\",\n    \"tamperDetected\": false,\n    \"lastExecutedAt\": \"2026-03-17T10:45:00Z\",\n    \"executionCount\": 5\n  }\n}\n```\n\n---\n\n## Workflow: From Creation to Discovery\n\n```\n1. Agent creates tool\n   matimo_create_tool(name=\"weather_fetch\", yaml, dir)\n   Result: ✅ Created, status=\"draft\"\n\n2. Agent validates with doctor\n   matimo_doctor(yaml)\n   Result: ✅ Valid, no policy errors\n\n3. Human approves via review\n   matimo_review(name=\"weather_fetch\", dir)\n   Result: ✅ Approved, status=\"approved\"\n\n4. Agent reloads registry\n   matimo_reload_tools(dir)\n   Result: ✅ Reloaded\n\n5. Agent lists to verify\n   matimo_list_user_tools(dir)\n   Result: ✅ \"weather_fetch\" appears with status=\"approved\"\n\n6. Agent uses the tool\n   matimo.execute(\"weather_fetch\", {city: \"New York\"})\n   Result: ✅ Tool executes, returns weather data\n```\n\n---\n\n## Key Principles\n\n1. ✅ **Status is authoritative** — How matimo_list_user_tools reports it is the truth\n2. ✅ **Risk level guides decisions** — Don't assume LOW-risk tools are safe; always understand what they do\n3. ✅ **Rejection is immutable** — If rejected by policy, it cannot be used (policy is frozen)\n4. ✅ **Approval lasts through session** — Approved tool stays approved until session ends\n5. ✅ **Metadata is useful** — createdAt, approvedBy, executionCount help understand tool history\n\n---\n\n## References\n\n- **Tool creation**: See `tool-creation` skill\n- **Tool lifecycle**: See `meta-tools-lifecycle` skill\n- **Policy validation**: See `policy-validation` skill\n\n---\n\n**Last Updated:** March 2026  \n**Status:** Complete  \n**Level:** Beginner\n","# Tool Discovery: Finding and Managing Tools\n\nThis skill teaches you how to **discover, search, and manage** Matimo tools that are available in your system.\n\n## Overview: Tool Sources\n\nThree sources of tools:\n\n1. **Core\u002FBuilt-in Tools** — Shipped with Matimo SDK\n   - `matimo_create_tool`, `matimo_validate_tool`, `matimo_doctor`, etc.\n   - Read-only, always available\n   - Used by agents to manage tool lifecycle\n\n2. **Provider Tools** — Application-specific tools from packages\n   - Slack tools, GitHub tools, AWS tools, etc.\n   - Defined in `packages\u002F{provider}\u002Ftools\u002F`\n   - Available after initialization with `toolPaths`\n\n3. **User-Created Tools** — Dynamically created by agents\n   - Stored in `target_dir` (usually temp directory)\n   - Status: `draft`, `approved`, `rejected`\n   - Discovered via `matimo_list_user_tools`\n\n---\n\n## Meta-Tool: matimo_list_user_tools\n\nLists all tools created by agents in a specific directory.\n\n```\nInput:  { target_dir: \"\u002Fpath\u002Fto\u002Ftools\" }\nOutput: { tools: [...] status: \"success\" }\n```\n\n### Basic Usage\n\n```\nCall: matimo_list_user_tools(target_dir=\"\u002Ftmp\u002Fmy-tools\")\n\nResponse:\n{\n  \"tools\": [\n    {\n      \"name\": \"weather_fetch\",\n      \"version\": \"1.0.0\",\n      \"description\": \"Get current weather for a city\",\n      \"status\": \"approved\",\n      \"riskLevel\": \"LOW\",\n      \"createdAt\": \"2026-03-17T10:30:00Z\",\n      \"executionType\": \"http\",\n      \"requiresApproval\": false\n    },\n    {\n      \"name\": \"file_reader\",\n      \"version\": \"1.0.0\",\n      \"description\": \"Read files from filesystem\",\n      \"status\": \"rejected\",\n      \"riskLevel\": \"CRITICAL\",\n      \"reason\": \"Command tools are blocked by policy\",\n      \"createdAt\": \"2026-03-17T10:31:00Z\",\n      \"executionType\": \"command\",\n      \"requiresApproval\": true\n    }\n  ],\n  \"summary\": {\n    \"total\": 2,\n    \"approved\": 1,\n    \"rejected\": 1,\n    \"draft\": 0\n  }\n}\n```\n\n---\n\n## Understanding Tool Status\n\n### Status: `approved`\n\nTool has been validated and approved by human operator. Ready to use.\n\n```\nIndicators:\n- ✅ Created with matimo_create_tool\n- ✅ Passed matimo_doctor validation\n- ✅ Human approved via matimo_review\n- ✅ Registry reloaded via matimo_reload_tools\n- ✅ Executable via matimo.execute()\n```\n\n**Example in response:**\n```json\n{\n  \"name\": \"weather_fetch\",\n  \"status\": \"approved\",\n  \"riskLevel\": \"LOW\",\n  \"message\": \"Ready for execution\"\n}\n```\n\n### Status: `draft`\n\nTool created but not yet approved. Cannot be executed.\n\n```\nIndicators:\n- ✅ Created with matimo_create_tool\n- ✅ Passed validation\n- ⏸️ Waiting for human approval via matimo_review\n- ❌ NOT executable\n```\n\n**Example in response:**\n```json\n{\n  \"name\": \"todo_create\",\n  \"status\": \"draft\",\n  \"riskLevel\": \"MEDIUM\",\n  \"message\": \"Awaiting human approval\"\n}\n```\n\n### Status: `rejected`\n\nTool failed policy validation or human rejected it. Cannot be used.\n\n```\nIndicators:\n- ❌ Failed policy check (e.g., command blocked)\n- OR: ❌ Human rejected after review\n- ❌ NOT executable\n- ❌ Marked as rejected\n```\n\n**Example in response:**\n```json\n{\n  \"name\": \"file_reader\",\n  \"status\": \"rejected\",\n  \"riskLevel\": \"CRITICAL\",\n  \"reason\": \"Command tools are blocked by policy. Use HTTP endpoints instead.\"\n}\n```\n\n---\n\n## Understanding Risk Levels\n\nRisk level indicates **potential impact** if the tool is misused or exploited:\n\n### Risk Level: `LOW`\n\n**When:** Read-only HTTP GET to public APIs\n\n```yaml\nexecution:\n  type: http\n  method: GET\n  url: \"https:\u002F\u002Fapi.github.com\u002Fusers\u002F{username}\"\n```\n\n**Why LOW:**\n- ✅ No data modification\n- ✅ Public API (no secrets)\n- ✅ Limited impact even if exposed\n- ✅ Auto-approved, no human approval needed\n\n---\n\n### Risk Level: `MEDIUM`\n\n**When:** Data modification via HTTP POST\u002FPUT\n\n```yaml\nexecution:\n  type: http\n  method: POST\n  url: \"https:\u002F\u002Fapi.slack.com\u002Fapi\u002Fchat.postMessage\"\n```\n\n**Why MEDIUM:**\n- ⚠️ Can modify data (send messages, create issues)\n- ⚠️ Requires credentials (API key)\n- ⚠️ Requires human review before execution\n- ✅ Policy allows it (HTTP only)\n\n---\n\n### Risk Level: `HIGH`\n\n**When:** Access to sensitive APIs or complex operations\n\n```yaml\nexecution:\n  type: http\n  method: DELETE\n  url: \"https:\u002F\u002Fapi.github.com\u002Frepos\u002F{owner}\u002F{repo}\"\n```\n\n**Why HIGH:**\n- ⚠️ Destructive operation (deletion)\n- ⚠️ Affects multiple users\n- ⚠️ Hard to undo\n- ✅ Policy allows it (HTTP only)\n- ⚠️ Requires careful human review\n\n---\n\n### Risk Level: `CRITICAL`\n\n**When:** Shell commands, code execution, or policy violations\n\n```yaml\nexecution:\n  type: command\n  command: bash\n  args: [\"-c\", \"{user_command}\"]\n```\n\n**Why CRITICAL:**\n- ❌ Full system access\n- ❌ Can read\u002Fwrite files, modify system\n- ❌ Cannot be restricted\n- ❌ Policy blocks (allowCommandTools: false)\n- ❌ Always rejected\n\n---\n\n## Query Examples\n\n### Example 1: List All Tools in a Directory\n\n```\nCall: matimo_list_user_tools(target_dir=\"\u002Ftmp\u002Fmatimo-tools\")\n\nWhat you'll see:\n- All tools created in that directory\n- Their current status (approved\u002Fdraft\u002Frejected)\n- Risk level and reason (if rejected)\n- Execution type and requirements\n```\n\n### Example 2: Check Which Tools Are Approved\n\nAgent logic:\n```\nCall: matimo_list_user_tools(target_dir=\"\u002Ftmp\u002Fmatimo-tools\")\nFilter: tools where status === \"approved\"\nResult: Only ready-to-use tools\n```\n\n**Use case:** \"What tools can I use right now?\"\n\n### Example 3: Check Why a Tool Was Rejected\n\nAgent logic:\n```\nCall: matimo_list_user_tools(target_dir=\"\u002Ftmp\u002Fmatimo-tools\")\nFind: tool named \"file_reader\"\nCheck: status === \"rejected\"\nRead: tool.reason\nOutput: \"Command tools are blocked by policy\"\n```\n\n**Use case:** \"Why doesn't file_reader work?\"\n\n### Example 4: Understand Tool Capabilities\n\nAgent logic:\n```\nCall: matimo_list_user_tools(target_dir=\"\u002Ftmp\u002Fmatimo-tools\")\nFor each tool:\n  - executionType: \"http\" or \"command\" or \"function\"\n  - riskLevel: \"LOW\" to \"CRITICAL\"\n  - requiresApproval: true\u002Ffalse\n\nDecision: Which tools match my goal?\n```\n\n**Use case:** \"What operations can I do?\"\n\n---\n\n## Complete Tool Information\n\nWhen `matimo_list_user_tools` returns a tool, it includes:\n\n```json\n{\n  \"name\": \"github_create_issue\",         \u002F\u002F Unique identifier\n  \"version\": \"1.0.0\",                    \u002F\u002F Semantic version\n  \"description\": \"Create an issue...\",   \u002F\u002F What it does\n  \"status\": \"approved\",                  \u002F\u002F approved | draft | rejected\n  \"riskLevel\": \"MEDIUM\",                 \u002F\u002F LOW | MEDIUM | HIGH | CRITICAL\n  \"createdAt\": \"2026-03-17T10:30:00Z\",   \u002F\u002F When created\n  \"executionType\": \"http\",               \u002F\u002F http | command | function\n  \"requiresApproval\": false,             \u002F\u002F approval needed for execution?\n  \"reason\": null,                        \u002F\u002F If rejected, why\n  \"approvedBy\": \"human-operator\",        \u002F\u002F Who approved it\n  \"approvedAt\": \"2026-03-17T10:31:00Z\",  \u002F\u002F When approved\n  \"parameters\": {                        \u002F\u002F Input parameters\n    \"owner\": { \"type\": \"string\", \"required\": true },\n    \"repo\": { \"type\": \"string\", \"required\": true },\n    \"title\": { \"type\": \"string\", \"required\": true }\n  }\n}\n```\n\n---\n\n## Common Discovery Patterns\n\n### Pattern 1: Report on All Tools\n\nAgent goal: \"What tools has the system created?\"\n\n```\nCall: matimo_list_user_tools(target_dir=\u003CprovidedDir>)\nOutput each tool:\n  - Name and description\n  - Status (✅ approved or ❌ rejected)\n  - Risk level\n\nSummary: \"System has 3 tools: 2 approved, 1 rejected\"\n```\n\n### Pattern 2: Find Tools Ready to Use\n\nAgent goal: \"What can I execute right now?\"\n\n```\nCall: matimo_list_user_tools(target_dir=\u003Cdir>)\nFilter: status === \"approved\" AND riskLevel !== \"CRITICAL\"\nThen: User can safely call matimo.execute(toolName, params)\n```\n\n### Pattern 3: Understand Why Tool Was Rejected\n\nAgent goal: \"Can I fix the rejected file_reader tool?\"\n\n```\nCall: matimo_list_user_tools(target_dir=\u003Cdir>)\nFind: \"file_reader\"\nRead: reason = \"Command tools are blocked by policy\"\nLearn: \"I can't fix this; policy is immutable. I need HTTP instead.\"\n```\n\n### Pattern 4: Summarize Safety Status\n\nAgent goal: \"Is the tool environment safe?\"\n\n```\nCall: matimo_list_user_tools(target_dir=\u003Cdir>)\nCount: CRITICAL-level tools\nIf count === 0:\n  Result: ✅ \"Safe—no critical-risk tools\"\nIf count > 0:\n  Result: ⚠️ \"Unsafe—{count} high-risk tools present\"\n```\n\n---\n\n## Meta-Tool: matimo_list_skills\n\nLists available **skills** (domain knowledge files) in the system.\n\n```\nCall: matimo_list_skills()\n\nResponse:\n{\n  \"skills\": [\n    {\n      \"name\": \"tool-creation\",\n      \"description\": \"Create tools for the Matimo SDK...\",\n      \"category\": \"Tool Development\",\n      \"difficulty\": \"intermediate\"\n    },\n    {\n      \"name\": \"meta-tools-lifecycle\",\n      \"description\": \"Master the tool lifecycle workflow...\",\n      \"category\": \"Tool Lifecycle\",\n      \"difficulty\": \"advanced\"\n    },\n    {\n      \"name\": \"policy-validation\",\n      \"description\": \"Security rules and enforcement...\",\n      \"category\": \"Security & Policy\",\n      \"difficulty\": \"intermediate\"\n    }\n  ],\n  \"summary\": {\n    \"total\": 3,\n    \"byCategory\": {\n      \"Tool Development\": 1,\n      \"Tool Lifecycle\": 1,\n      \"Security & Policy\": 1\n    }\n  }\n}\n```\n\n### When to Use Skills\n\n```\nAgent: \"I need to learn how to create a tool\"\nAgent: matimo_list_skills()\nAgent: \"I found 'tool-creation' skill. Let me apply it to my task.\"\nResult: Agent generates better YAML with complete structure\n```\n\n---\n\n## Meta-Tool: matimo_get_tool_status\n\nGets detailed status of a specific tool.\n\n```\nCall: matimo_get_tool_status(toolName=\"weather_fetch\", target_dir=\"\u002Ftmp\u002Ftools\")\n\nResponse:\n{\n  \"name\": \"weather_fetch\",\n  \"status\": \"approved\",\n  \"details\": {\n    \"createdAt\": \"2026-03-17T10:30:00Z\",\n    \"approvedAt\": \"2026-03-17T10:31:00Z\",\n    \"approvedBy\": \"human-operator\",\n    \"integrityHash\": \"sha256:abc123...\",\n    \"tamperDetected\": false,\n    \"lastExecutedAt\": \"2026-03-17T10:45:00Z\",\n    \"executionCount\": 5\n  }\n}\n```\n\n---\n\n## Workflow: From Creation to Discovery\n\n```\n1. Agent creates tool\n   matimo_create_tool(name=\"weather_fetch\", yaml, dir)\n   Result: ✅ Created, status=\"draft\"\n\n2. Agent validates with doctor\n   matimo_doctor(yaml)\n   Result: ✅ Valid, no policy errors\n\n3. Human approves via review\n   matimo_review(name=\"weather_fetch\", dir)\n   Result: ✅ Approved, status=\"approved\"\n\n4. Agent reloads registry\n   matimo_reload_tools(dir)\n   Result: ✅ Reloaded\n\n5. Agent lists to verify\n   matimo_list_user_tools(dir)\n   Result: ✅ \"weather_fetch\" appears with status=\"approved\"\n\n6. Agent uses the tool\n   matimo.execute(\"weather_fetch\", {city: \"New York\"})\n   Result: ✅ Tool executes, returns weather data\n```\n\n---\n\n## Key Principles\n\n1. ✅ **Status is authoritative** — How matimo_list_user_tools reports it is the truth\n2. ✅ **Risk level guides decisions** — Don't assume LOW-risk tools are safe; always understand what they do\n3. ✅ **Rejection is immutable** — If rejected by policy, it cannot be used (policy is frozen)\n4. ✅ **Approval lasts through session** — Approved tool stays approved until session ends\n5. ✅ **Metadata is useful** — createdAt, approvedBy, executionCount help understand tool history\n\n---\n\n## References\n\n- **Tool creation**: See `tool-creation` skill\n- **Tool lifecycle**: See `meta-tools-lifecycle` skill\n- **Policy validation**: See `policy-validation` skill\n\n---\n\n**Last Updated:** March 2026  \n**Status:** Complete  \n**Level:** Beginner\n",{"name":5,"metadata":24,"description":7},{"apply-to":25,"category":26,"difficulty":27},"matimo_list_user_tools matimo_list_skills matimo_get_tool_status","Tool Management","beginner","main","3ace42f8c811a205651ca8cf53bc2608abffc266","typescript\u002Fpackages\u002Fcore\u002Fskills\u002Ftool-discovery",1,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Ftallclub_matimo","https:\u002F\u002Fgithub.com\u002Freview-bench","https:\u002F\u002Freview-bench.ai","An open benchmark for AI code review.","2026-10-27 08:01:51",{"source":8,"skillName":5,"commands":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add review-bench\u002Ftallclub_matimo --skill tool-discovery",{"tool":43,"command":44},"bunx","bunx skills add review-bench\u002Ftallclub_matimo --skill tool-discovery",{"tool":46,"command":47},"pnpm","pnpm dlx skills add review-bench\u002Ftallclub_matimo --skill tool-discovery","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Freview-bench\u002Ftallclub_matimo\u002Fblob\u002Fmain\u002Ftypescript\u002Fpackages\u002Fcore\u002Fskills\u002Ftool-discovery\u002FSKILL.md",true,[],[52,59,66,73,80,87],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M752QFT5TGZZ68013YTNW8J3","twilio","Complete guide to all Twilio tools — text, media, delivery tracking, E.164 formatting, and message management.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Ftallclub_matimo\u002Fblob\u002Fmain\u002Ftypescript\u002Fpackages\u002Ftwilio\u002Fskills\u002Ftwilio\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M752QAKQFZKM84MN9R5334VX","slack","Complete guide to all Slack tools — messaging, channels, users, search, files, reactions, and threads.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Ftallclub_matimo\u002Fblob\u002Fmain\u002Ftypescript\u002Fpackages\u002Fslack\u002Fskills\u002Fslack\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M752Q60H6SQAHAH9BB2MZQN6","postgres","Complete guide to all PostgreSQL tools — parameterized queries, schema navigation, data retrieval, and safe database interaction patterns.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Ftallclub_matimo\u002Fblob\u002Fmain\u002Ftypescript\u002Fpackages\u002Fpostgres\u002Fskills\u002Fpostgres\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M752Q2700VY1QWPACWX8AVFQ","notion","Complete guide to all Notion tools — databases, pages, blocks, queries, and content management.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Ftallclub_matimo\u002Fblob\u002Fmain\u002Ftypescript\u002Fpackages\u002Fnotion\u002Fskills\u002Fnotion\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M752PZ82SCVF6H1GPKQ54JWR","mailchimp","Complete guide to all Mailchimp tools — campaigns, audiences, lists, templates, segments, and email marketing.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Ftallclub_matimo\u002Fblob\u002Fmain\u002Ftypescript\u002Fpackages\u002Fmailchimp\u002Fskills\u002Fmailchimp\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M752PQW4F1SP8DXQMFMYKDBK","hubspot","Complete guide to all HubSpot CRM tools — contacts, companies, deals, tickets, products, line items, pipelines, and entity management.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Ftallclub_matimo\u002Fblob\u002Fmain\u002Ftypescript\u002Fpackages\u002Fhubspot\u002Fskills\u002Fhubspot\u002FSKILL.md",[],[]]