---
description: Synchronization constraints when editing agent skill packages under .agents/skills/
globs: .agents/skills/**
alwaysApply: false
---

# Skill Package Maintenance

When modifying any skill package, follow the maintenance rule in `AGENTS.md` — keep the per-skill bundle (SKILL.md + scripts/ + references/), shared modules, and remote-code-parity files in sync.

## Script conventions (supplemental to AGENTS.md)

- CLI parsers must accept common aliases and disable brittle prefix-abbreviation.
- Progress on `stderr` (`__VAWS_PROGRESS__=<json>`), final payload on `stdout` (single JSON object).
- Default metadata that can be safely inferred; never silently default security-sensitive values.