← Back to repOptics

Research

Aggregate insights from every repo scanned by repOptics. What makes great repos, common pitfalls, and where the ecosystem stands.

3520
Repos Scanned
7945
Total Scans
4428
Re-scans (Deltas)
13
Intent Types

Grade Distribution

How scanned repos are graded across the ecosystem

B (33%)
C (35%)
D (16%)
F (12%)
A: 369 (5%)
B: 2639 (33%)
C: 2749 (35%)
D: 1239 (16%)
F: 949 (12%)

Benchmarks by Intent

Average scores and grade profiles per repo type

Production

C
61.1avg
Health
59.8
Launch
62.3
Maturity
61.1
1495 repos3139 scansp50: 63

Library

B
69.3avg
Health
68.3
Launch
70.7
Maturity
69
534 repos1137 scansp50: 71

Framework

B
73.3avg
Health
72
Launch
74.6
Maturity
73.1
372 repos822 scansp50: 75
Show remaining 10 intents ▼

Documentation

F
35.6avg
Health
37.2
Launch
35.9
Maturity
33.3
183 repos769 scansp50: 30

Open Source

B
67.9avg
Health
64.3
Launch
69.3
Maturity
69.9
352 repos638 scansp50: 70

Educational

C
59avg
Health
55.6
Launch
60.3
Maturity
61.2
286 repos530 scansp50: 61

Curated List

C
54.5avg
Health
53
Launch
55
Maturity
55.4
109 repos339 scansp50: 56

CLI Tool

B
72.1avg
Health
70.4
Launch
73.6
Maturity
72.4
125 repos215 scansp50: 73

Runtime

B
69.2avg
Health
66.7
Launch
70.4
Maturity
70.6
80 repos167 scansp50: 72

Specification

B
70.3avg
Health
67.9
Launch
71.2
Maturity
71.8
95 repos107 scansp50: 70

Prototype

C
52.8avg
Health
51.6
Launch
53.1
Maturity
53.8
53 repos60 scansp50: 58.5

Client Demo

B
64.2avg
Health
64
Launch
65.6
Maturity
62.8
13 repos18 scansp50: 63

Internal Tool

D
40avg
Health
41.8
Launch
41.3
Maturity
37.3
4 repos4 scansp50: 41

Common Pitfalls

Checks that fail most often across all scans

% of scanned repos in the lake where this specific check came back failing. Higher = more common pitfall across the population. This is nota per-repo score — it's a frequency across all scans.

Check
Category
% of repos failing
Fails / Scans
Duplicates
File Tidiness
80%
6328 / 7945
Large Files
File Tidiness
54%
4278 / 7945
Readme Rationale
Decisions
46%
3658 / 7945
Lead Time
Delivery
37%
2919 / 7945
Show remaining 21 pitfalls ▼
Governance
Governance
33%
2601 / 7945
Structure
Architecture
33%
2588 / 7945
Code Scanning
Security
28%
2250 / 7945
Codeowners
Governance
25%
1960 / 7945
Agents
Governance
24%
1877 / 7945
Dependabot
Security
23%
1813 / 7945
Security Policy
Security
22%
1786 / 7945
Fresh
Dependencies
19%
1495 / 7945
No Major
Dependencies
16%
1259 / 7945
Contributing
Governance
15%
1200 / 7945
License
Governance
15%
1177 / 7945
No Minor
Dependencies
15%
1172 / 7945
Ci
Delivery
14%
1135 / 7945
Workspace Readme Coverage
Architecture
14%
489 / 3570
Issue Templates
Governance
12%
991 / 7945
Committed Artifacts
File Tidiness
8%
658 / 7945
Vulnerabilities
Security
7%
593 / 7945
No Vulns
Dependencies
7%
593 / 7945
Readme Comprehensive
Architecture
4%
290 / 7945
Readme Exists
Architecture
1%
69 / 7945
Generated Ratio
File Tidiness
0%
1 / 7945

Quick Win Leaderboard

Most frequently recommended quick wins

1
Package manifest exists
1390 repos · 31% of scans
trivial
2
No oversized files committed
945 repos · 31% of scans
moderate
3
Dependabot configured
1213 repos · 30% of scans
easy
4
README explains design rationale
717 repos · 18% of scans
easy
5
No oversized files committed
588 repos · 15% of scans
moderate
Show remaining 63 quick wins ▼
6
No minor updates pending
459 repos · 13% of scans
trivial
7
Code scanning (SAST)
487 repos · 12% of scans
easy
8
Coherent folder structure
201 repos · 10% of scans
moderate
9
Decision records exist
435 repos · 10% of scans
easy
10
No known dependency vulnerabilities
376 repos · 9% of scans
trivial
11
README explains design rationale
158 repos · 8% of scans
easy
12
No major updates pending
323 repos · 7% of scans
moderate
13
No build artifacts committed
276 repos · 7% of scans
easy
14
CI/CD workflows exist
269 repos · 7% of scans
easy
15
Dependabot configured
253 repos · 6% of scans
easy
16
No known vulnerabilities
238 repos · 6% of scans
trivial
17
CODEOWNERS file exists
252 repos · 6% of scans
easy
18
Decision records exist
261 repos · 6% of scans
easy
19
CODEOWNERS file exists
262 repos · 6% of scans
easy
20
Decision records exist
286 repos · 6% of scans
easy
21
Changelog or release notes exist
198 repos · 5% of scans
easy
22
CODEOWNERS file exists
170 repos · 3% of scans
easy
23
No known vulnerabilities
155 repos · 3% of scans
trivial
24
No suspicious duplicate files
142 repos · 3% of scans
moderate
25
README explains design rationale
140 repos · 3% of scans
easy
26
Package manifest exists
140 repos · 3% of scans
trivial
27
Code scanning (SAST)
104 repos · 3% of scans
easy
28
Changelog or release notes exist
98 repos · 3% of scans
easy
29
Workspace README coverage
98 repos · 2% of scans
easy
30
CI/CD workflows exist
53 repos · 2% of scans
easy
31
Coherent folder structure
70 repos · 2% of scans
moderate
32
Architecture diagrams exist
60 repos · 1% of scans
easy
33
Fast PR lead time
62 repos · 1% of scans
moderate
34
No build artifacts committed
57 repos · 1% of scans
easy
35
Clear entrypoint
54 repos · 1% of scans
moderate
36
Security policy exists
58 repos · 1% of scans
easy
37
README is comprehensive
13 repos · 1% of scans
moderate
38
No known dependency vulnerabilities
41 repos · 1% of scans
trivial
39
LICENSE file exists
47 repos · 1% of scans
easy
40
CONTRIBUTING.md exists
43 repos · 1% of scans
easy
41
PR template exists
45 repos · 1% of scans
easy
42
GOVERNANCE.md exists
35 repos · 1% of scans
moderate
43
CONTRIBUTING.md exists
27 repos · 1% of scans
easy
44
Changelog or release notes exist
30 repos · 1% of scans
easy
45
Dependabot configured
31 repos · 1% of scans
easy
46
CONTRIBUTING.md exists
40 repos · 1% of scans
easy
47
PR template exists
44 repos · 1% of scans
easy
48
Architecture diagrams exist
32 repos · 1% of scans
easy
49
LICENSE file exists
17 repos · 1% of scans
easy
50
LICENSE file exists
25 repos · 1% of scans
easy
51
Workspace README coverage
19 repos · 1% of scans
easy
52
CI/CD workflows exist
31 repos · 1% of scans
easy
53
Workspace README coverage
10 repos · 0% of scans
easy
54
No suspicious duplicate files
21 repos · 0% of scans
moderate
55
Security policy exists
15 repos · 0% of scans
easy
56
No major updates pending
10 repos · 0% of scans
moderate
57
README exists
8 repos · 0% of scans
easy
58
Clear entrypoint
8 repos · 0% of scans
moderate
59
PR template exists
5 repos · 0% of scans
easy
60
README exists
6 repos · 0% of scans
easy
61
Code scanning (SAST)
4 repos · 0% of scans
easy
62
No build artifacts committed
3 repos · 0% of scans
easy
63
Issue or PR templates exist
2 repos · 0% of scans
moderate
64
CONTRIBUTING defines standards
2 repos · 0% of scans
moderate
65
Clear entrypoint
1 repos · 0% of scans
moderate
66
Fast PR lead time
1 repos · 0% of scans
moderate
67
README exists
1 repos · 0% of scans
easy
68
README is comprehensive
1 repos · 0% of scans
moderate

Vulnerability Landscape

% of repositories affected by known vulnerabilities

IntentCriticalHighModerateLow
library5%19%21%13%
production1%5%6%4%
Show remaining 11 rows ▼
framework4%14%14%7%
cli-tool2%8%9%3%
prototype3%5%5%5%
curated-list1%1%2%1%
educational0%2%4%1%
open-source0%1%1%0%
runtime-4%7%4%
docs-2%3%0%
specification-3%3%2%
client-demo-17%11%11%
internal-tool----

Score Trends

Weekly averages over the last 90 days

WeekAvg ScoreHealthLaunchMaturityScans
Apr 666.163.367.467.51936
Apr 1361.959.263.363.1683
Show remaining 7 weeks ▼
Apr 2061.859.263.2631148
Apr 2759.657.360.860.5662
May 460.959.86260.81258
May 115859.258.955.8934
May 1859.860.760.757.8830
May 2558.560.259.655.5135
Jun 159.560.560.157.6359

Shareable Insights

Data-backed findings ready for sharing

pitfall

80% of scanned repos fail the duplicates check.

Most affected intents: runtime, framework, educational, cli-tool, production, open-source, library, specification, prototype, client-demo, internal-tool, curated-list.

Based on 7945scans · click to expand

pitfall

54% of scanned repos fail the large files check.

Most affected intents: educational, runtime, framework, docs, production, curated-list, internal-tool, library, open-source, prototype, specification, cli-tool.

Based on 7945scans · click to expand

benchmark

Framework repos score highest (avg 73.3), Documentation repos score lowest (avg 35.6).

Gap of 37.7 points. Framework: 822 scans, Documentation: 769 scans.

Based on 7945scans · click to expand

quick-win

"Package manifest exists" is the most common quick win, recommended in 31% of scans.

Recommended 2433 times across 1390 repos. Effort: trivial.

Based on 7945scans · click to expand

Show remaining 18 insights ▼
benchmark

The most common grade for Production repos is C.

Based on 3139 scans across 1495 repos. Median score: 63.

Based on 3139scans · click to expand

benchmark

The most common grade for Library repos is B.

Based on 1137 scans across 534 repos. Median score: 71.

Based on 1137scans · click to expand

benchmark

The most common grade for Framework repos is B.

Based on 822 scans across 372 repos. Median score: 75.

Based on 822scans · click to expand

benchmark

The most common grade for Documentation repos is F.

Based on 769 scans across 183 repos. Median score: 30.

Based on 769scans · click to expand

benchmark

The most common grade for Open Source repos is B.

Based on 638 scans across 352 repos. Median score: 70.

Based on 638scans · click to expand

benchmark

The most common grade for Educational repos is C.

Based on 530 scans across 286 repos. Median score: 61.

Based on 530scans · click to expand

benchmark

The most common grade for Curated List repos is C.

Based on 339 scans across 109 repos. Median score: 56.

Based on 339scans · click to expand

benchmark

The most common grade for CLI Tool repos is B.

Based on 215 scans across 125 repos. Median score: 73.

Based on 215scans · click to expand

benchmark

The most common grade for Runtime repos is B.

Based on 167 scans across 80 repos. Median score: 72.

Based on 167scans · click to expand

benchmark

The most common grade for Specification repos is B.

Based on 107 scans across 95 repos. Median score: 70.

Based on 107scans · click to expand

benchmark

The most common grade for Prototype repos is C.

Based on 60 scans across 53 repos. Median score: 58.5.

Based on 60scans · click to expand

benchmark

The most common grade for Client Demo repos is B.

Based on 18 scans across 13 repos. Median score: 63.

Based on 18scans · click to expand

benchmark

The most common grade for Internal Tool repos is D.

Based on 4 scans across 4 repos. Median score: 41.

Based on 4scans · click to expand

pitfall

46% of scanned repos fail the readme rationale check.

Most affected intents: docs, client-demo, internal-tool, curated-list, production, library, open-source, prototype, educational, cli-tool, specification, framework.

Based on 7945scans · click to expand

pitfall

37% of scanned repos fail the lead time check.

Most affected intents: specification, runtime, educational, prototype, open-source, cli-tool, client-demo, production, framework, library.

Based on 7945scans · click to expand

pitfall

33% of scanned repos fail the governance check.

Most affected intents: docs, cli-tool, curated-list, production, framework, client-demo, library.

Based on 7945scans · click to expand

quick-win

7 quick wins require minimal effort.

Top low-effort wins: Package manifest exists, No minor updates pending, No known dependency vulnerabilities.

Based on 7945scans · click to expand

general

38% of repos earn an A or B, while 28% score D or F.

Grade breakdown across 7945 scans: A: 369, B: 2639, C: 2749, D: 1239, F: 949.

Based on 7945scans · click to expand