AgentSkillsCN

metrics

当用户提出“/gobby 指标”、“工具指标”、“使用统计”、“性能报告”等需求时，可使用此技能。查看工具使用指标、性能统计数据，并识别表现不佳的工具。

SKILL.md
--- frontmatter
name: metrics
description: This skill should be used when the user asks to "/gobby metrics", "tool metrics", "usage stats", "performance report". View tool usage metrics, performance statistics, and identify failing tools.
category: core

/gobby metrics - Metrics and Statistics Skill

This skill retrieves usage metrics via the gobby-metrics MCP tools (e.g., get_tool_metrics(), get_top_tools(), get_failing_tools()). Parse the user's input to determine which subcommand to execute.

Subcommands

/gobby metrics tools - Tool usage statistics

Call get_tool_metrics with:

  • •server_name: Optional filter by server name
  • •tool_name: Optional filter by tool name
  • •project_id: Optional project scope

Returns per-tool statistics:

  • •Call count
  • •Success rate
  • •Average latency
  • •Last used

Example: /gobby metrics tools → get_tool_metrics() Example: /gobby metrics tools gobby-tasks → get_tool_metrics(server_name="gobby-tasks") Example: /gobby metrics tools gobby-tasks create_task → get_tool_metrics(server_name="gobby-tasks", tool_name="create_task")

/gobby metrics top - Get top tools by usage

Call get_top_tools with:

  • •limit: Max tools to show (default 10)
  • •order_by: Sort by "usage" (default), "success_rate", or "latency"
  • •project_id: Optional project scope

Returns tools ranked by the specified metric.

Example: /gobby metrics top → get_top_tools() Example: /gobby metrics top 20 by latency → get_top_tools(limit=20, order_by="latency")

/gobby metrics failing - Get failing tools

Call get_failing_tools with:

  • •threshold: Failure rate threshold (default 0.1 = 10%)
  • •limit: Max results
  • •project_id: Optional project scope

Returns tools with failure rates above the threshold.

Example: /gobby metrics failing → get_failing_tools() Example: /gobby metrics failing 0.05 → get_failing_tools(threshold=0.05)

/gobby metrics success <server> <tool> - Get tool success rate

Call get_tool_success_rate with:

  • •server_name: (required) Server name
  • •tool_name: (required) Tool name
  • •project_id: (optional) Project ID - automatically inferred from current session context if not provided

Returns detailed success rate for a specific tool. The project_id is optional because it can be inferred from the current working directory's .gobby/project.json file.

Example: /gobby metrics success gobby-tasks create_task → get_tool_success_rate(server_name="gobby-tasks", tool_name="create_task")

/gobby metrics reset - Reset metrics

Call reset_metrics with:

  • •project_id: Optional - reset for specific project
  • •server_name: Optional - reset for specific server
  • •tool_name: Optional - reset for specific tool

Clears metrics data. Can scope to project, server, or specific tool.

Example: /gobby metrics reset → reset_metrics() Example: /gobby metrics reset gobby-tasks → reset_metrics(server_name="gobby-tasks")

/gobby metrics cleanup - Clean up old metrics

Call cleanup_old_metrics to delete metrics older than retention period (default 7 days).

Example: /gobby metrics cleanup → cleanup_old_metrics()

/gobby metrics retention - Get retention statistics

Call get_retention_stats to see metrics age distribution and storage info.

Example: /gobby metrics retention → get_retention_stats()

Response Format

After executing the appropriate MCP tool, present the results clearly:

  • •For tools: Table with tool name, call count, success rate, avg latency
  • •For top: Ranked list with the sorting metric highlighted
  • •For failing: Table of failing tools with failure rates
  • •For success: Detailed success rate with context
  • •For reset: Confirmation of what was reset
  • •For cleanup: Summary of deleted metrics
  • •For retention: Statistics about metrics age

Metrics Concepts

  • •Call count: Total number of tool invocations
  • •Success rate: Percentage of calls that completed without error
  • •Latency: Response time in milliseconds
  • •Retention: How long metrics are kept (default 7 days)

Error Handling

If the subcommand is not recognized, show available subcommands:

  • •tools, top, failing, success, reset, cleanup, retention