How do I install the @6171/drift Detector skill?

Run npx skillmds@latest add starchild-ai-agent/6171-drift-detector in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is @6171/drift Detector safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with @6171/drift Detector?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is @6171/drift Detector free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published @6171/drift Detector?

starchild-ai-agent (@starchild-ai-agent) published this skill. Their other Agent Skills are listed on their SkillMD profile.

@6171/drift Detector by starchild-ai-agent

Name: @6171/drift Detector
Author: starchild-ai-agent

@6171/drift Detector

Compare two JSON or CSV snapshots by primary key and report added, removed, and changed records. Use for billing reconciliation, external-system sync checks, data quality audits, and scheduled drift monitoring.

File contents

Drift Detector

Use scripts/drift.py to compare a local snapshot with an external or previous snapshot without requiring third-party packages. It supports JSON arrays/objects and CSV files, aligns rows by a required primary-key column/field, and emits machine-readable JSON.

Run

python3 scripts/drift.py old.json new.json --key id
python3 scripts/drift.py old.csv new.csv --key customer_id --fields plan,status
python3 scripts/drift.py old.json new.json --key id --fail-on-drift

Use --fields to limit comparisons. Nested JSON values are compared as JSON values. Missing records are classified as added or removed; matching records with field differences appear under changed with a field-level before/after map.

Output and exit codes

Output is a single JSON document containing summary, added, removed, and changed. summary.has_drift is true when any difference exists. The default exit code is 0 even when drift is found, which is convenient for reports. With --fail-on-drift, exit code 2 indicates drift and exit code 0 indicates no drift; malformed input or invalid arguments exit 1.

For scheduled reconciliation, persist the prior report and alert only when summary.has_drift changes or remains actionable. Treat a clean local webhook-derived snapshot as advisory until reconciled against the authoritative source.

Constraints

Inputs must be JSON or CSV and use the same format/compatible fields.
Keys must be unique and present in every row; duplicates and missing keys are errors.
The tool reads files only and never calls external services or modifies inputs.

Frequently asked questions