pocketbaselisted
Install: claude install-skill hsb3/dotfiles-agents
# PocketBase Skill
Operate PocketBase backend projects (standalone binary or Go package mode) with bundled Python scripts and references.
## Skill Resources
Use resources in this skill directory first:
- `scripts/` - executable helpers for auth, collections, records, backups, migration template generation
- `references/` - detailed backend docs to load on demand
- `assets/` - migration templates
Prefer `--help` output and this guide first. If behavior is unclear, read only the relevant script file.
In commands below, replace `<skill-dir>` with the absolute installed directory
containing this SKILL.md. Keep the consuming project as cwd: the helpers resolve its
`.env` there, and generated migrations belong to that project, not the plugin cache.
## Codex companion setup
Resolve `<plugin-root>` from this installed skill's `skills/` parent. With Python
3.11+, register or refresh the package's project profiles before delegation:
```bash
python3 "<plugin-root>/hooks/_lib/codex_roles.py" --plugin-root "<plugin-root>" .
python3 "<plugin-root>/hooks/_lib/codex_roles.py" --plugin-root "<plugin-root>" --check .
```
Start a fresh Codex session and use the exact native role selector:
| Work | Native role |
|---|---|
| Scoped implementation | `pocketbase-pb-builder` |
| Independent verification | `pocketbase-pb-reviewer` |
| Access-control audit | `pocketbase-pocketbase-security-auditor` |
The companion hook injects canonical role context from this package. Registration
and ins