# AGENTS.md

`ink-skills` contains reusable Ink-specific Agent Skills and one symlink installer.

## Layout

- `skills/<name>/SKILL.md` — one narrowly triggered on-demand behavior.
- `bin/ink-skills` — POSIX linker/importer; stdout is TSV, diagnostics stderr.
- `test/install-smoke.sh` — installer contract smoke.

## Rules

- A skill owns reusable judgment, never runtime policy or repeatable mechanics.
- Ink source and `SPEC.md` own host behavior; `toolset` owns external executables.
- Keep skill names lowercase and hyphenated; directory and frontmatter name must match.
- `link` only creates symlinks. `import` may materialize only a caller-supplied,
  SHA-256-verified local archive in the content-addressed store. Do not add URL,
  Git, credential, registry, package-manager, prompt, or updater behavior.
- Run `sh -n bin/ink-skills`, `sh test/install-smoke.sh`, and
  `sh test/skills-smoke.sh` after changes.