Tighten skill script policy and prompt assembly

1 files changed, 10 insertions, 0 deletions

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..f02a0dc
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,10 @@
+# AGENTS.md
+
+## Scripting Policy
+
+- For easy, cheap, standalone Python scripts in this repo, use `uv` inline script metadata.
+- Use the `#!/usr/bin/env -S uv run --script` shebang.
+- Add a PEP 723 inline TOML block with `requires-python` and `dependencies`.
+- Keep dependency pins exact when a script has non-stdlib Python dependencies.
+- Use common sense. Do not force this onto heavy or specialized runtimes, bespoke project environments, or scripts that intentionally run inside a dedicated external environment.
+- In particular, avoid slapping `uv` metadata onto heavyweight OCR/runtime entrypoints just to satisfy the rule mechanically.