skill-maintenance git:20260622.4c29d90A

Immutable. This exact content is served forever at /api/v1/blob/d41737a509ada1e5.

---
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` plus supporting `scripts/`, `references/`, `agents/`, and similar files), 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.