Agent skill
stix2-validator
Validate STIX 2.1 JSON files and bundles against the STIX specification. Use when validating threat intelligence data, checking STIX bundle integrity before ingestion, verifying indicator/malware/attack-pattern objects have required fields, or bulk-validating directories of STIX files. Provides detailed error reports showing which objects failed and why.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/stix2-validator
SKILL.md
STIX 2.1 Validator
Validate STIX 2.1 JSON bundles using the official stix2-validator library.
Requirements
Install the validator library before use:
pip install stix2-validator --break-system-packages
Usage
Validate a Single File
python scripts/validate_stix.py /path/to/bundle.json
Validate a Directory
python scripts/validate_stix.py /path/to/stix_files/
Add -r for recursive subdirectory scanning.
Options
| Option | Description |
|---|---|
--strict |
Enable all optional validation checks |
--enforce-refs |
Warn when object references don't resolve within the bundle |
-r, --recursive |
Recursively validate files in subdirectories |
--json |
Output results as JSON for programmatic use |
-q, --quiet |
Suppress success messages, show only errors |
JSON Output
For integration with other tools, use --json:
python scripts/validate_stix.py bundle.json --json
Returns structured output:
{
"file": "bundle.json",
"valid": false,
"errors": [
{"id": "indicator--abc123", "type": "", "message": "'pattern_type' is a required property"}
],
"warnings": []
}
Error Categories
The validator checks for:
- Schema errors: Missing required properties, invalid property types
- Format errors: Malformed UUIDs, invalid timestamps, incorrect ID formats
- Reference errors: Unresolved object references (with
--enforce-refs) - Semantic errors: Invalid STIX patterns, constraint violations
Exit Codes
0: All files valid1: Validation errors found or file not found
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?