Refactor agent skills

This commit is contained in:
pleb
2026-07-10 08:42:55 -07:00
parent f4fedaeb34
commit 26def9609d
8 changed files with 291 additions and 102 deletions
@@ -8,6 +8,13 @@ description: Audit Beat Saber plugin-helper locks for available plugin updates a
Use this skill from the `plugin-helper` repo to produce an update audit, not to
blindly update plugins. Keep public, private, and experimental sources distinct.
Before auditing, read the shared policy references:
- [repo-workflow.md](../references/repo-workflow.md) for repo root, `.venv`, `PYTHONPATH=src`, dirty worktree handling, and validation commands.
- [state-and-profiles.md](../references/state-and-profiles.md) for `.state`, profiles, install identity, instance selection, and checkout locations.
- [artifact-policy.md](../references/artifact-policy.md) for GitHub/BeatMods/private-source/checksum policy.
- [live-validation.md](../references/live-validation.md) only when reviewing smoke-test notes or launch failures.
## Workflow
1. Confirm repo context:
@@ -17,8 +24,9 @@ blindly update plugins. Keep public, private, and experimental sources distinct.
git status --short
```
2. Choose the instance from the user request. If omitted, prefer `1.44.1` only
when that is clearly the active migration context; otherwise list instances:
2. Choose the instance from the user request. If omitted, use the latest
available BSInstance unless the current task context clearly points at
another instance:
```bash
PYTHONPATH=src .venv/bin/python -m plugin_helper instances
@@ -36,7 +44,8 @@ blindly update plugins. Keep public, private, and experimental sources distinct.
verified metadata, skips `patreon/` and `discord/` sources, and marks local,
PR, manual, failed-trial, or pending-smoke entries as review items.
4. Read the compatibility tracker before proposing updates for review items:
4. Read the active compatibility tracker before proposing updates for review
items. For the current migration notes, inspect:
```bash
sed -n '1,380p' docs/notes/install-and-verify-plugins-1.44.1.md
@@ -49,9 +58,8 @@ blindly update plugins. Keep public, private, and experimental sources distinct.
compatible source.
5. For each public update candidate, inspect source notes before changing the
lock. Prefer upstream GitHub release artifacts when available; use BeatMods
CDN only for verified fallback cases, BeatMods-only packages, inaccessible
upstream assets, or framework/library dependencies.
lock. Follow the shared artifact policy for GitHub-first sourcing and
BeatMods fallback cases.
6. Do not attempt automated public update checks for: