goSprinto/compliance-skills / pii-detector
pii-detector
VerifiedProactive PII add-on — augments the main response with PII guidance. Auto-trigger on any form, schema, migration, model, API route, GraphQL resolver, auth flow, or data design discussion. Also fires on: middleware, webhooks, workers, seed/fixture/factory files, delete/export/purge/anonymize functions, cron jobs, HTTP clients, controllers, services, resolvers. Trigger phrases: "build a form", "collect X data", "what fields should I include", "how should I design the schema", "POC / lead / contact / user / customer information", "store / save / persist X", "sign up / login / auth / registration", "share thoughts on how to build". Trigger on field names: email, phone, name, dob, ssn, card, cvv, password, token, secret, api_key, health, biometric, ip_address, salary, session, device_id, notes, metadata (on user-facing models).
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 3.6 KB |
| SKILL.md | skill md | 6.3 KB |
| layers/api-layer.md | markdown | 8.9 KB |
| layers/auth-sessions.md | markdown | 6.6 KB |
| layers/data-in-transit.md | markdown | 7.1 KB |
| layers/data-lifecycle.md | markdown | 9.3 KB |
| layers/frontend.md | markdown | 5.8 KB |
| layers/legal-consent.md | markdown | 3.9 KB |
| layers/testing-seeding.md | markdown | 6.0 KB |
| modes/inline.md | markdown | 5.7 KB |
| modes/planning.md | markdown | 4.7 KB |
| modes/repo-scan.md | markdown | 6.5 KB |
| patterns/fields.md | markdown | 3.8 KB |
| rules/leakage-vectors.md | markdown | 5.7 KB |
| rules/non-negotiables.md | markdown | 3.5 KB |
README.md
View on GitHub# pii-detector
> Automatic PII detection and privacy compliance checks for US-based companies.
> Powered by [Sprinto](https://sprinto.com).
[](https://sprinto.com)
---
## Install
```bash
# Using npx (Node.js)
npx skills add gosprinto/compliance-skills/pii-detector
# Using Claude Code directly
claude skills add gosprinto/compliance-skills/pii-detector
```
---
## What It Does
Fires automatically — no trigger needed — during:
- **Planning & design discussions** — weaves PII considerations into architecture advice
- **Code generation** — checks before writing, generates correct code in one pass
- **Repo scan** — full audit with file + line references and a compliance summary
---
## Coverage
### Regulations
CCPA/CPRA · HIPAA · PCI-DSS · COPPA · GLBA · BIPA · FERPA · FTC Act
### Layers
| Layer | What It Catches |
|-------|----------------|
| Data models & schemas | Plaintext passwords, unencrypted SSN/health fields, missing deletedAt, no consent timestamp |
| Auth & sessions | PII in JWT payload, tokens in localStorage, no expiry, weak reset tokens, OTP storage |
| API layer | Full object responses, IDOR, GraphQL introspection, CORS misconfiguration, rate limiting |
| Frontend | PII in localStorage, cookie flags, consent gates, session replay capturing inputs |
| Data in transit | PII in URLs, hardcoded HTTP, webhook signature missing, HTTPS/HSTS not enforced |
| Testing & seeding | Real PII in seed files, fixtures, factories, snapshot files, prod DB in tests |
| Data lifecycle | No hard-delete, cascade gaps, bad anonymization, no export endpoint, no retention jobs |
| Legal & consent | Debug log level in prod, no cookie consent library, missing privacy policy / ToS routes |
---
## Modes
### Planning / Review
When you ask "how should I build X" or "review this schema" — PII observations
are woven into Claude's natural response. No separate report.
### Generation
When Claude is writing new code — checks run before the first line is generated.
Corrected code is produced in a single pass.
### Repo Scan
Say "scan my repo" or "PII audit" — produces a structured report with:
- 🔴 Critical findings (fix before deploy)
- 🟡 Important findings (fix within 30 days)
- 🟢 Suggestions
- Full compliance summary table across all layers
---
## Example Triggers
The skill fires on any of these — no explicit request needed:
```
"Build a User model with email, password, and date of birth"
"Create a login flow with JWT"
"Review my users table"
"Add a delete account endpoint"
"I want to build a lead capture form"
"Scan my repo for PII issues"
```
---
## File Structure
```
pii-detector/
├── SKILL.md ← entry point + mode routing
├── modes/
│ ├── planning.md ← enrich responses during discussion/review
│ ├── inline.md ← check-first generation mode
│ └── repo-scan.md ← full audit orchestration + report format
├── layers/
│ ├── api-layer.md
│ ├── auth-sessions.md
│ ├── data-in-transit.md
│ ├── data-lifecycle.md
│ ├── frontend.md
│ ├── legal-consent.md
│ └── testing-seeding.md
├── patterns/
│ └── fields.md ← full PII field pattern dictionary
└── rules/
├── non-negotiables.md ← hard rules (passwords, CVV, SSN, health)
└── leakage-vectors.md ← logs, analytics, serializers, config
```
---
*Built by [Sprinto](https://sprinto.com) — compliance automation for fast-growing companies.*
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |