signalk-registry

SignalK Registry Score

The SignalK plugin registry scores every plugin on a 100-point scale and re-tests nightly. This skill does two things:

1. Reads the actual published score for the plugin (the ground truth — don't guess it).
2. Previews the criteria you can act on locally before the next nightly run, and shows the point cost of each gap.

Our bar: we publish/maintain to 100. Anything below means a gap below is open.

Scoring rubric

The 0–100 score is test-harness/score.ts (base, max 100) minus a plugin-CI penalty applied in build-api.ts. So without plugin-CI the ceiling is 90, not 100.

Category	Points	Evaluated
Installs	20	Registry harness only
Loads	15	Registry harness only
Activates	15	Registry harness only
Schema	5	Registry harness only
Tests pass	25	Registry harness only
Security audit	0–20	Locally checkable
Changelog	−5 if missing	Locally checkable
Screenshots	−5 if missing	Locally checkable
Plugin-CI	−10 if missing	Locally checkable (workflow file)

Install / load / activate / schema / tests (80 pts) run in the registry's own harness against a live SignalK server — you can't reproduce them locally, but the published JSON (Check 0) reports their booleans. The rest you can fix in the repo before the next nightly.

Check 0 — actual published score (do this first)

The registry serves each plugin's results as JSON. The slug is the npm name with @ stripped and / → __.

PKG=$(node -p "require('./package.json').name")            # @sailingnaturali/signalk-currents
SLUG=$(printf '%s' "$PKG" | sed 's/^@//; s#/#__#')         # sailingnaturali__signalk-currents
curl -s "https://signalk.org/signalk-plugin-registry/plugins/$SLUG.json" -o /tmp/sk-reg.json
python3 - <<'PY'
import json
d = json.load(open('/tmp/sk-reg.json'))
vers = d.get('versions', {})
latest = max(vers, key=lambda v: [int(x) for x in v.split('.') if x.isdigit()]) if vers else None
slot = (vers.get(latest, {}) or {}).get('server@stable', {}) if latest else {}
print(f"latest tested version: {latest}")
print(f"  composite: {slot.get('composite')}")
print(f"  badges: {slot.get('badges')}")
print(f"  installs/loads/activates: {slot.get('installs')}/{slot.get('loads')}/{slot.get('activates')}")
print(f"  tests: {slot.get('test_status')}  audit C/H/M: {slot.get('audit_critical')}/{slot.get('audit_high')}/{slot.get('audit_moderate')}")
print(f"  plugin_ci: {d.get('plugin_ci', {}).get('status')}")
PY