skillstat 0.1.0__tar.gz

skillstat-0.1.0/.gitignore

@@ -0,0 +1,28 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/

skillstat-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Qin-Yu Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

skillstat-0.1.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: skillstat
+Version: 0.1.0
+Summary: Diagnose, audit, and optimize your AI agent skill usage across tools
+Project-URL: Homepage, https://github.com/QY0831/skillstat
+Project-URL: Repository, https://github.com/QY0831/skillstat
+Project-URL: Issues, https://github.com/QY0831/skillstat/issues
+Author: Qin-Yu Chen
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,analytics,claude,cli,copilot,skills
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Requires-Dist: inquirerpy>=0.3.4
+Requires-Dist: rich>=13.0
+Description-Content-Type: text/markdown
+
+# skillstat 🩺
+
+Diagnose, audit, and optimize your AI agent skill usage across tools.
+
+## Install
+
+```bash
+# Option 1: pipx (recommended — isolated env, global command)
+pipx install skillstat
+
+# Option 2: curl one-liner
+curl -fsSL https://raw.githubusercontent.com/QY0831/skillstat/main/install.sh | bash
+
+# Option 3: pip
+pip install skillstat
+```
+
+## Usage
+
+```bash
+# Interactive mode (prompts for source, time window, etc.)
+skillstat
+
+# Non-interactive
+skillstat --source copilot claude --all
+skillstat --source copilot --days 30 --json
+skillstat --source opencode --all --limit 20
+```
+
+## What it does
+
+```
+⚡ skillstat
+  ✓ Found 100 installed skills
+  ✓ Health check: 95 healthy, 5 with issues
+  ✓ GitHub Copilot: 70 skill events
+  ✓ Claude Code: 25 skill events
+
+╭───────────────── 📊 Skill Usage Report ──────────────────╮
+│   Sources:   GitHub Copilot, Claude Code                  │
+│   Skills:    100 installed, 28 used, 72 unused            │
+╰──────────────────────────────────────────────────────────╯
+
+  # Skill          Loads  Sessions  Projects
+  1 diagnose          18       15         7  ████████
+  2 aws-cdk            7        6         5  ███░░░░░
+  ...
+
+╭───────────────── 🔍 Skill Audit ─────────────────────────╮
+│  ⭐ MOST USED — last 4 weeks                              │
+│  ▲ RISING — diagnose ↑1600%                               │
+│  ⚠ STALE — find-skills (unused 28+ days)                  │
+│  ◈ CROSS-PROJECT — diagnose (7 projects)                  │
+│  ◇ ONE-OFF — aws-serverless (used once)                   │
+╰──────────────────────────────────────────────────────────╯
+```
+
+## Supported agents
+
+| Agent | Storage | Detection method |
+|-------|---------|-----------------|
+| GitHub Copilot | `~/.copilot/session-store.db` | `<skill-context name="...">` |
+| Claude Code | `~/.claude/` | Slash commands + `Skill` tool_use |
+| Codex CLI | `~/.codex/sessions/` | `<name>X</name>` in responses |
+| OpenCode | `~/.local/share/opencode/` | SQLite `tool='skill'` |
+| Grok CLI | `~/.grok/sessions/` | `<command-name>` in updates |
+| Droid CLI | `~/.factory/sessions/` | `Skill "X" is now active` |
+
+## Features
+
+- **Health Check** — validates SKILL.md structure (name, description, file size)
+- **Skill Audit** — classifies skills: most-used / rising / declining / stale / one-off / cross-project
+- **Multi-source** — aggregates across all your AI tools in one report
+- **JSON output** — `--json` for piping to jq, dashboards, CI
+- **Zero config** — auto-detects installed agents, no setup needed
+
+## Skill directories scanned
+
+```
+~/.agents/skills/
+~/.claude/skills/
+~/.copilot/skills/
+~/.copilot/installed-plugins/
+~/.claude/plugins/
+```
+
+## License
+
+MIT

skillstat-0.1.0/README.md

@@ -0,0 +1,89 @@
+# skillstat 🩺
+
+Diagnose, audit, and optimize your AI agent skill usage across tools.
+
+## Install
+
+```bash
+# Option 1: pipx (recommended — isolated env, global command)
+pipx install skillstat
+
+# Option 2: curl one-liner
+curl -fsSL https://raw.githubusercontent.com/QY0831/skillstat/main/install.sh | bash
+
+# Option 3: pip
+pip install skillstat
+```
+
+## Usage
+
+```bash
+# Interactive mode (prompts for source, time window, etc.)
+skillstat
+
+# Non-interactive
+skillstat --source copilot claude --all
+skillstat --source copilot --days 30 --json
+skillstat --source opencode --all --limit 20
+```
+
+## What it does
+
+```
+⚡ skillstat
+  ✓ Found 100 installed skills
+  ✓ Health check: 95 healthy, 5 with issues
+  ✓ GitHub Copilot: 70 skill events
+  ✓ Claude Code: 25 skill events
+
+╭───────────────── 📊 Skill Usage Report ──────────────────╮
+│   Sources:   GitHub Copilot, Claude Code                  │
+│   Skills:    100 installed, 28 used, 72 unused            │
+╰──────────────────────────────────────────────────────────╯
+
+  # Skill          Loads  Sessions  Projects
+  1 diagnose          18       15         7  ████████
+  2 aws-cdk            7        6         5  ███░░░░░
+  ...
+
+╭───────────────── 🔍 Skill Audit ─────────────────────────╮
+│  ⭐ MOST USED — last 4 weeks                              │
+│  ▲ RISING — diagnose ↑1600%                               │
+│  ⚠ STALE — find-skills (unused 28+ days)                  │
+│  ◈ CROSS-PROJECT — diagnose (7 projects)                  │
+│  ◇ ONE-OFF — aws-serverless (used once)                   │
+╰──────────────────────────────────────────────────────────╯
+```
+
+## Supported agents
+
+| Agent | Storage | Detection method |
+|-------|---------|-----------------|
+| GitHub Copilot | `~/.copilot/session-store.db` | `<skill-context name="...">` |
+| Claude Code | `~/.claude/` | Slash commands + `Skill` tool_use |
+| Codex CLI | `~/.codex/sessions/` | `<name>X</name>` in responses |
+| OpenCode | `~/.local/share/opencode/` | SQLite `tool='skill'` |
+| Grok CLI | `~/.grok/sessions/` | `<command-name>` in updates |
+| Droid CLI | `~/.factory/sessions/` | `Skill "X" is now active` |
+
+## Features
+
+- **Health Check** — validates SKILL.md structure (name, description, file size)
+- **Skill Audit** — classifies skills: most-used / rising / declining / stale / one-off / cross-project
+- **Multi-source** — aggregates across all your AI tools in one report
+- **JSON output** — `--json` for piping to jq, dashboards, CI
+- **Zero config** — auto-detects installed agents, no setup needed
+
+## Skill directories scanned
+
+```
+~/.agents/skills/
+~/.claude/skills/
+~/.copilot/skills/
+~/.copilot/installed-plugins/
+~/.claude/plugins/
+```
+
+## License
+
+MIT

skillstat-0.1.0/install.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# skillstat installer — curl one-liner:
+#   curl -fsSL https://raw.githubusercontent.com/QY0831/skillstat/main/install.sh | bash
+set -euo pipefail
+
+REPO="user/skillstat"
+INSTALL_DIR="${SKILLSTAT_INSTALL_DIR:-$HOME/.local/bin}"
+
+echo "⚡ Installing skillstat..."
+
+# Check Python version
+if ! command -v python3 &>/dev/null; then
+    echo "❌ python3 not found. Please install Python 3.10+."
+    exit 1
+fi
+
+PY_VERSION=$(python3 -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')")
+PY_MAJOR=$(echo "$PY_VERSION" | cut -d. -f1)
+PY_MINOR=$(echo "$PY_VERSION" | cut -d. -f2)
+
+if [ "$PY_MAJOR" -lt 3 ] || { [ "$PY_MAJOR" -eq 3 ] && [ "$PY_MINOR" -lt 10 ]; }; then
+    echo "❌ Python 3.10+ required (found $PY_VERSION)"
+    exit 1
+fi
+
+# Prefer pipx if available
+if command -v pipx &>/dev/null; then
+    echo "📦 Installing via pipx..."
+    pipx install skillstat 2>/dev/null || pipx upgrade skillstat
+    echo "✅ Installed! Run: skillstat"
+    exit 0
+fi
+
+# Fallback: pip install to user site + wrapper script
+echo "📦 Installing via pip (user)..."
+python3 -m pip install --user --quiet --break-system-packages skillstat 2>/dev/null \
+    || python3 -m pip install --user --quiet skillstat
+
+# Ensure install dir exists
+mkdir -p "$INSTALL_DIR"
+
+# Create wrapper if not already on PATH via pip
+if ! command -v skillstat &>/dev/null; then
+    WRAPPER="$INSTALL_DIR/skillstat"
+    cat > "$WRAPPER" << 'EOF'
+#!/usr/bin/env python3
+from skillstat.cli import main
+raise SystemExit(main())
+EOF
+    chmod +x "$WRAPPER"
+    echo "📍 Installed to $WRAPPER"
+
+    if [[ ":$PATH:" != *":$INSTALL_DIR:"* ]]; then
+        echo ""
+        echo "⚠️  Add to your PATH:"
+        echo "   export PATH=\"$INSTALL_DIR:\$PATH\""
+    fi
+fi
+
+echo "✅ Done! Run: skillstat"

skillstat-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "skillstat"
+version = "0.1.0"
+description = "Diagnose, audit, and optimize your AI agent skill usage across tools"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "Qin-Yu Chen" }]
+keywords = ["ai", "agent", "skills", "copilot", "claude", "cli", "analytics"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "rich>=13.0",
+    "InquirerPy>=0.3.4",
+]
+
+[project.scripts]
+skillstat = "skillstat.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/QY0831/skillstat"
+Repository = "https://github.com/QY0831/skillstat"
+Issues = "https://github.com/QY0831/skillstat/issues"

skillstat-0.1.0/src/skillstat/__init__.py

@@ -0,0 +1,3 @@
+"""skillstat — AI agent skill usage analytics."""
+
+__version__ = "0.1.0"

skillstat-0.1.0/src/skillstat/__main__.py

@@ -0,0 +1,4 @@
+"""Allow running as `python -m skillstat`."""
+from skillstat.cli import main
+
+raise SystemExit(main())