AGENTS.md ยท diff
git:20260723.863a000 to git:20260723.7e570cb
3 added, 4 removed. Audit A to A.
# Repository instructions
- ## Scope
-
- This repository contains three independently installable Agent Skills. Keep the repository local-first, dependency-free at runtime, and safe for personal writing data.
+ Three independently installable Agent Skills. Keep the repository local-first, dependency-free at runtime, and safe for personal writing data.
## Before editing
- Read the nearest SKILL.md and every reference needed for the change.
- Keep each skill self-contained. A skill must not reference files outside its own directory at runtime.
- Use fictional fixtures only. Never copy a personal profile, export, held-out response, credential, or eval run into Git.
- Preserve the boundary between cases.jsonl and references.jsonl.
## Implementation
- - Use Node.js standard-library modules. Do not add a dependency for work the standard library handles clearly.
+ - Scripts are TypeScript run directly by Node's type stripping, so keep every file to erasable syntax (no enums, namespaces, or parameter properties).
+ - Use Node.js standard-library modules. Do not add a runtime dependency for work the standard library handles clearly.
- Spawn local agents with argument arrays and stdin, never through an interpolated shell command.
- Keep deterministic data work in scripts and language judgment in the invoking agent.
- Use plan, validate, execute for profile replacement and other multi-file writes.
- Keep tone rules in private profiles. Runtime instructions must not hard-code one person's stylistic habits.
- Persistent user data belongs under TONE_OF_VOICE_HOME, never inside an installed skill.
## Verification
Before declaring a change complete:
npm test
uvx --from skills-ref agentskills validate skills/tone-of-voice
uvx --from skills-ref agentskills validate skills/train-tone-of-voice
uvx --from skills-ref agentskills validate skills/evaluate-tone-of-voice
Model-backed smoke tests are opt-in. CI and ordinary unit tests must use fictional fixtures and stub executables.