docs: add project skill and Directus extension playbook

- project skill: invariants, presets/formats, backfill/scheduler,
  debugging, verification gate, deploy checklist
- AGENTS.md points at the project and global skills
This commit is contained in:
Rawman Grey 2026-10-25 15:15:12 +03:00
parent ee39633ad7
commit 1758f2f9c5
3 changed files with 130 additions and 1 deletions

View file

@ -10,6 +10,14 @@ admin UI never pays the first-request sharp cost.
Bundle entries: an api **hook** (`files.upload`), an api **endpoint** (`/image-previews/*`), and an app
**module** (`image-previews` admin page: progress, storage, config, diagnostics, API reference).
## Skills
- **Project skill**: `.opencode/skills/directus-image-previews/SKILL.md` — invariants, presets/formats
semantics, backfill/scheduler behavior, debugging, verification gate, deploy checklist. Read it before
changing generation logic.
- **Global skill**: `directus-extensions` — reusable Directus extension playbook (bundles, context APIs,
storage, asset transforms, scheduling, sandboxing, deployment, links). Use it for new extensions.
Tested against Directus **11.17.4** (self-hosted, PM2 cluster, local disk storage). The manifest targets
`^11.0.0`; the extension uses non-public `@directus/api` internals at runtime, so re-verify on each
Directus minor upgrade.