skill-performance-profiler

Analyze skill usage patterns to optimize token consumption across conversations.

49|7|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/Exploration-labs/Nates-Substack-Skills --skill skill-performance-profiler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-performance-profiler
Source: https://github.com/Exploration-labs/Nates-Substack-Skills/tree/main/skill-performance-profiler
Command: npx skills add https://github.com/Exploration-labs/Nates-Substack-Skills --skill skill-performance-profiler

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Understanding and optimizing AI skill usage, token consumption, and co-occurrence patterns is crucial for efficiency and cost management. This skill provides deep, actionable insights into how your skills are actually used, helping you make informed optimization decisions.

Core Features & Use Cases

  • Usage Pattern Analysis: Tracks skill invocation frequency, total and average token consumption, and identifies "heavy" vs. "lightweight" skills.
  • Co-occurrence Detection: Discovers which skills are frequently used together, highlighting potential consolidation opportunities to streamline workflows.
  • Comprehensive Reporting: Generates detailed markdown reports or CSV exports with executive summaries, skill categories, efficiency rankings, and co-occurrence patterns.
  • Conversation Data Collection: Integrates with the recent_chats tool to gather conversation history, providing a rich dataset for analysis.
  • Use Case: You suspect some of your skills are consuming too many tokens or are redundant. Use this skill to get a full analysis of your skill usage over the last month, identifying the most token-heavy skills and suggesting opportunities to consolidate frequently used skill pairs.

Quick Start

Analyze my skill usage over the last 30 conversations to identify the heaviest skills and any consolidation opportunities.

Frequently Asked Questions about skill-performance-profiler

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze skill token consumption across conversations?

Token consumption analysis tracks invocation frequency, total and average tokens per skill, and identifies heavy versus lightweight performers. This skill integrates conversation history to calculate efficiency metrics and rank skills by resource usage, helping you spot optimization targets across sessions.

Can I identify which skills are used together most often?

Co-occurrence detection discovers skill pairs and groups invoked together frequently, revealing consolidation opportunities. The analysis generates reports highlighting these patterns so you can streamline redundant or overlapping skill combinations.

What output formats does skill usage reporting support?

Reports are exported in markdown and CSV formats with executive summaries, efficiency rankings, skill categorization, and co-occurrence data. Both formats preserve the full analysis for different downstream workflows—markdown for readability, CSV for further processing.

How does this skill gather conversation data for analysis?

The skill integrates with the recent_chats tool to pull conversation histories, building a rich dataset of skill invocations and token counts. This historical data fuels accurate usage pattern detection and trend analysis across your specified time window.

What should I do before running a usage analysis?

Ensure you have access to conversation history data through the recent_chats integration. Define your analysis scope—number of recent conversations or time period—so the skill can collect complete invocation and token records for comprehensive reporting.

Can I use this to identify skills consuming disproportionate tokens?

Yes. Usage pattern analysis ranks skills by total and average token consumption, flagging outliers and heavy consumers. This lets you prioritize optimization, consolidation, or replacement of the most resource-intensive skills in your workflow.

Related Skills