---
name: security-registry
description: Skill signature registry — view stats, scan and register skills, search known fingerprints
---

# Skill Registry

Track scanned skills by fingerprint. Three sub-commands.

## Sub-command: Stats (default)

```bash
node -e "
import { getStats, listEntries } from '<plugin-root>/scanners/lib/skill-registry.mjs';
const stats = getStats('<plugin-root>');
const entries = listEntries('<plugin-root>', 5);
console.log(JSON.stringify({ stats, entries }));
" --input-type=module
```

Show: total entries, last scan date, 5 most recent entries.

## Sub-command: Scan

```bash
node -e "
import { fingerprintSkill, checkRegistry } from '<plugin-root>/scanners/lib/skill-registry.mjs';
const r = fingerprintSkill('<target>');
const c = checkRegistry(r.fingerprint, '<plugin-root>');
console.log(JSON.stringify({ fingerprint: r.fingerprint, name: r.name, files: r.files, ...c }));
" --input-type=module
```

If cached and not stale: show cached result. If miss or stale: run full scan, then register:

```bash
node -e "
import { registerScan } from '<plugin-root>/scanners/lib/skill-registry.mjs';
registerScan({ skillPath: '<target>', fingerprint: '<fp>', name: '<name>', files: <files>, verdict: '<v>', risk_score: <n>, counts: <counts>, files_scanned: <n> }, '<plugin-root>');
" --input-type=module
```

## Sub-command: Search

```bash
node -e "
import { searchRegistry } from '<plugin-root>/scanners/lib/skill-registry.mjs';
const results = searchRegistry('<pattern>', '<plugin-root>');
console.log(JSON.stringify(results));
" --input-type=module
```

Show matching entries with verdict, risk score, last scanned date.