Skip to content

jeremylongshore/tons-of-skills-marketplace / plugins/database/sql-query-optimizer/skills/optimizing-sql-queries

optimizing-sql-queries

Verified

Execute use when you need to work with query optimization. This skill provides query performance analysis with comprehensive guidance and automation. Trigger with phrases like "optimize queries", "analyze performance", or "improve query speed".

FileKindSize
SKILL.mdskill md6.8 KB
assets/README.mdmarkdown153 B
references/README.mdmarkdown62 B
scripts/README.mdmarkdown429 B
scripts/analyze_query.pyexecutablescript4.6 KB
scripts/explain_query.pyexecutablescript2.7 KB

scripts/analyze_query.py

View on GitHub
#!/usr/bin/env python3
"""
sql-query-optimizer - Analysis Script
Analyzes the SQL query and identifies potential bottlenecks.
Generated: 2025-12-10 03:48:17
"""

import json
import argparse
from pathlib import Path
from typing import Dict
from datetime import datetime


class Analyzer:
    def __init__(self, target_path: str):
        self.target_path = Path(target_path)
        self.stats = {"total_files": 0, "total_size": 0, "file_types": {}, "issues": [], "recommendations": []}

    def analyze_directory(self) -> Dict:
        """Analyze directory structure and contents."""
        if not self.target_path.exists():
            self.stats["issues"].append(f"Path does not exist: {self.target_path}")
            return self.stats

        for file_path in self.target_path.rglob("*"):
            if file_path.is_file():
                self.analyze_file(file_path)

        return self.stats

    def analyze_file(self, file_path: Path):
        """Analyze individual file."""
        self.stats["total_files"] += 1
        self.stats["total_size"] += file_path.stat().st_size

        # Track file types
        ext = file_path.suffix.lower()
        if ext:
            self.stats["file_types"][ext] = self.stats["file_types"].get(ext, 0) + 1

        # Check for potential issues
        if file_path.stat().st_size > 100 * 1024 * 1024:  # 100MB
            self.stats["issues"].append(f"Large file: {file_path} ({file_path.stat().st_size // 1024 // 1024}MB)")

        if file_path.stat().st_size == 0:
            self.stats["issues"].append(f"Empty file: {file_path}")

    def generate_recommendations(self):
        """Generate recommendations based on analysis."""
        if self.stats["total_files"] == 0:
            self.stats["recommendations"].append("No files found - check target path")

        if len(self.stats["file_types"]) > 20:
            self.stats["recommendations"].append("Many file types detected - consider organizing")

        if self.stats["total_size"] > 1024 * 1024 * 1024:  # 1GB
            self.stats["recommendations"].append("Large total size - consider archiving old data")

    def generate_report(self) -> str:
        """Generate analysis report."""
        report = []
        report.append("\n" + "=" * 60)
        report.append("ANALYSIS REPORT - sql-query-optimizer")
        report.append("=" * 60)
        report.append(f"Target: {self.target_path}")
        report.append(f"Generated: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
        report.append("")

        # Statistics
        report.append("📊 STATISTICS")
        report.append(f"  Total Files: {self.stats['total_files']:,}")
        report.append(f"  Total Size: {self.stats['total_size'] / 1024 / 1024:.2f} MB")
        report.append(f"  File Types: {len(self.stats['file_types'])}")

        # Top file types
        if self.stats["file_types"]:
            report.append("\n📁 TOP FILE TYPES")
            sorted_types = sorted(self.stats["file_types"].items(), key=lambda x: x[1], reverse=True)[:5]
            for ext, count in sorted_types:
                report.append(f"  {ext or 'no extension'}: {count} files")

        # Issues
        if self.stats["issues"]:
            report.append(f"\n⚠️  ISSUES ({len(self.stats['issues'])})")
            for issue in self.stats["issues"][:10]:
                report.append(f"  - {issue}")
            if len(self.stats["issues"]) > 10:
                report.append(f"  ... and {len(self.stats['issues']) - 10} more")

        # Recommendations
        if self.stats["recommendations"]:
            report.append("\n💡 RECOMMENDATIONS")
            for rec in self.stats["recommendations"]:
                report.append(f"  - {rec}")

        report.append("")
        return "\n".join(report)


def main():
    parser = argparse.ArgumentParser(description="Analyzes the SQL query and identifies potential bottlenecks.")
    parser.add_argument("target", help="Target directory to analyze")
    parser.add_argument("--output", "-o", help="Output report file")
    parser.add_argument("--json", action="store_true", help="Output as JSON")

    args = parser.parse_args()

    print(f"🔍 Analyzing {args.target}...")
    analyzer = Analyzer(args.target)
    stats = analyzer.analyze_directory()
    analyzer.generate_recommendations()

    if args.json:
        output = json.dumps(stats, indent=2)
    else:
        output = analyzer.generate_report()

    if args.output:
        Path(args.output).write_text(output)
        print(f"✓ Report saved to {args.output}")
    else:
        print(output)

    return 0 if len(stats["issues"]) == 0 else 1


if __name__ == "__main__":
    import sys

    sys.exit(main())
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall