🧠 pyteam-skills

Generate a team skill matrix and interactive dashboard from your Git commit history.
It mines repositories with PyDriller, maps files to skills (via extensions, paths, or regex), applies configurable weights with recency decay, and produces both CSV exports and a modern Tailwind dashboard (with dark mode + filters).

🚀 Features

• 🪄 Git mining via PyDriller
• 🧩 Skill mapping precedence: regex → path prefix → extension → Other
• ⚖️ Weighted scoring — with configurable parameters and exponential recency decay
• 📊 Normalized skill matrix (1–100) — top contributor per skill = 100
• 📈 Monthly trends — per skill, normalized (1–100)
• 🌗 Static dashboard — filters by Author, Skill, Month + dark mode + download JSON
• 🧰 CLI-powered workflow: init, scan, matrix, dashboard
• 🚧 More features coming soon!

🛠️ Installation (Development Mode)

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

For normal installation:

pip install pyteam-skills

⚡ Quickstart

# 1) Create a default configuration
pyteam-skills init --out config.yml

# 2) Scan a Git repository
pyteam-skills scan --repo . --config config.yml --out artifacts/scan.json

# 3) Export CSV artifacts
pyteam-skills matrix --scan artifacts/scan.json --out artifacts

# 4) Generate the interactive dashboard
pyteam-skills dashboard --scan artifacts/scan.json --out artifacts/dashboard

# 5) Open your dashboard in a browser
open artifacts/dashboard/index.html

⚙️ Config Reference

See examples/config.example.yml.

Skill Mapping Precedence

1. regex_skills (first match wins)
2. path_skills (longest prefix wins)
3. extension_skills
4. fallback → ["Other"]

Weight Parameters

🧪 Development

make format   # Format code with black
make lint     # Run ruff linter
make test     # Run pytest
make all      # Format + lint + test

📜 License

MIT License © Hassan Zaib Hayat