Evaluate open source GitHub projects against 30 KPIs across community health, maintenance, security, documentation, adoption, and code quality
npx claudepluginhub maxamillion/skill-oss-project-kpi-evaluationEvaluates open source projects against 30 Key Performance Indicators using multi-agent research with parallel subagents for bias-free assessment
A Claude Code skill that evaluates open source projects against Key Performance Indicators using multi-agent research. Performs live web research to gather current metrics on community health, maintenance, security, documentation, adoption, and code quality.
| Category | Weight | What It Measures |
|---|---|---|
| Community Health | 16.67% | Contributor count, growth rate, bus factor, engagement |
| Maintenance | 16.67% | Commit frequency, release cadence, issue/PR resolution time |
| Security | 16.67% | Security policy, vulnerability disclosure, dependency status |
| Documentation | 16.67% | README, API docs, guides, changelog, contributing guide |
| Adoption | 16.67% | Stars, forks, downloads, dependent projects |
| Code Quality | 16.67% | Tests, coverage, CI/CD, code review practices |
Add the marketplace and install the plugin:
/plugin marketplace add maxamillion/skill-oss-project-kpi-evaluation
/plugin install oss-kpi-evaluation@maxamillion-skill-oss-project-kpi-evaluation
Or use the interactive plugin manager:
/plugin
Clone the repository:
git clone https://github.com/maxamillion/skill-oss-project-kpi-evaluation.git
Add as a local marketplace and install:
/plugin marketplace add ./skill-oss-project-kpi-evaluation
/plugin install oss-kpi-evaluation@skill-oss-project-kpi-evaluation
gh): Authenticated for API accessEvaluate the project: https://github.com/fastapi/fastapi
Evaluate specific categories:
Evaluate https://github.com/psf/requests focusing on security and maintenance
Adjust category importance:
Evaluate https://github.com/owner/repo with weights:
- Security: 30%
- Maintenance: 25%
- Community: 15%
- Adoption: 15%
- Documentation: 10%
- Code Quality: 5%
Set a pass/fail threshold:
Evaluate https://github.com/owner/repo with minimum score 4.0
The skill generates a structured report containing:
| Score | Rating | Meaning |
|---|---|---|
| 4.5-5.0 | Excellent | Low risk, high quality project |
| 3.5-4.4 | Good | Healthy project, minor improvements needed |
| 2.5-3.4 | Adequate | Acceptable but review carefully |
| 1.5-2.4 | Concerning | Significant risks, proceed with caution |
| 1.0-1.4 | Critical | Major issues, high risk adoption |
Detailed documentation is available in the oss-kpi-evaluation/skills/oss-kpi-evaluation/references/ directory:
| Document | Description |
|---|---|
KPI-FRAMEWORK.md | Complete metric definitions and scoring rubrics |
DATA-SOURCES.md | Data collection methods and APIs |
RESEARCH-PROMPTS.md | Subagent prompt templates |
BIAS-PREVENTION.md | Quality control protocols |
REPORT-TEMPLATE.md | Output format specification |
MIT License - see LICENSE for details.
Adam Miller (@admiller)