AGENTS.md git:20260723.863a000A

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

# 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.

## 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.
- 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.