meltedinhex/analyst-ai-pack / skills/writing-suricata-and-snort-rules
writing-suricata-and-snort-rules
VerifiedWrites and validates Suricata/Snort IDS rules for network-based malware detection, covering rule anatomy, content/pcre matching, flow and threshold options, and common mistakes that cause false positives or no matches. Activates for requests to write a Suricata rule, create Snort signatures, or build network detection rules from IOCs or C2 patterns.
Writing Suricata and Snort Rules
When to Use
- You need to author IDS rules to detect C2 traffic, malware downloads, or exploit attempts from observed network indicators.
- You want to validate rule syntax and avoid the patterns that cause false positives or silent non-matching.
Do not use broad content matches on common substrings that will flood alerts — anchor with
flow direction, ports, offsets, and uniqueness. This skill builds and lints rules; deploy them
through your IDS change process.
Prerequisites
- The indicators to detect (URI, host header, TLS SNI/JA3, byte pattern) and a target IDS (Suricata or Snort).
Workflow
Step 1: Draft the rule
Choose action, protocol, addresses/ports, direction, and a unique msg, sid, and rev. Add
content/pcre matches anchored with http.uri, tls.sni, flow:established,to_server, and
offsets/depths.
Step 2: Lint the rule
python scripts/analyst.py lint rules.rules
Checks for required fields (msg, sid, rev, classtype), balanced quotes/parentheses,
non-anchored overly short content, and duplicate SIDs.
Step 3: Tune to reduce noise
Add threshold/detection_filter, flowbits, and specific buffers (http.host, dns.query)
to scope matches.
Step 4: Document and stage
Record what each rule detects and stage it for testing against a pcap before production.
Validation
- Every rule has
msg, a uniquesid, and arev. contentmatches are anchored (buffer/offset/flow) rather than free-floating short strings.- Rules parse without unbalanced quotes/parentheses.
Pitfalls
- Free-floating
content:"GET"style matches creating massive false positives. - Duplicate or reused SIDs causing rule-load conflicts.
- Forgetting
flow:establishedand matching on unrelated traffic directions.
References
- See
references/api-reference.mdfor the linter. - Suricata and Snort rule docs (linked in frontmatter).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |