| name | comment-safety-filter |
| description | Apply a project-specific safety rulepack (medical-advice, PII, blocklist, length) to an array of items with `.text` fields. Returns each item annotated with a safety block. Use in engagement flows — filter incoming comments AND outgoing reply drafts through the same rulepack. |
| metadata | {"clawdbot":{"emoji":"🛡️","requires":["node"],"credentials":"none — stateless filter"}} |
Comment Safety Filter
General-purpose safety filter. Projects author their own rulepack JSON; this skill applies it uniformly — same patterns for incoming comments and outgoing replies.
Install
cd ~/clawd/skills/comment-safety-filter
pnpm install
pnpm run build
Usage
comment-safety-filter \
--input comments.json \
--rulepack rules/my-podcast-safety.json \
--output triaged.json
Each item gets a safety: {passed, reasons[]} block added. passed = reasons.length === 0 (empty reasons = safe).
Rulepack format
{
"medical_advice_patterns": [
{ "pattern": "\\byou should take\\b", "label": "direct medication instruction" }
],
"pii_patterns": [
{ "pattern": "[\\w.+-]+@[\\w.-]+\\.\\w{2,}", "label": "email" },
{ "pattern": "https?://[^\\s]+", "label": "URL" }
],
"blocklist": ["scam", "crypto rug"],
"allowlist": ["quoting the paper:"],
"max_length": 500,
"flags": "i"
}
- medical_advice_patterns / pii_patterns — regex sources, tagged with a label that appears in the reason report.
- blocklist — exact phrase match, case-insensitive.
- allowlist — if any allowlist phrase is found, the item passes unconditionally (useful for quoted-text edge cases).
- max_length — hard cap on text length.
- flags — regex flags applied to every compiled pattern. Default
i.
Flags
| Flag | Default | Notes |
|---|
--input <path> | required | JSON array or {comments: [...]} |
--rulepack <path> | required | The project's rulepack JSON |
--output <path> | — | Write triaged JSON to this file (otherwise inline in stdout) |
Error classification
error | Meaning |
|---|
config | Missing files, malformed JSON, or invalid regex in rulepack |
Callers
- Every
universal-engagement phase — filter incoming comments AND outgoing reply drafts with the same rulepack
- Project-specific engagement directives that want consistent filtering semantics
See also
youtube-comments — upstream source of comments; same JSON shape as this skill's --input- Vault Overview:
08 - System/Agent Skills/comment-safety-filter - Skill Overview.md
