Skip to content

ahstn/oceans-llm / .agents/skills/verify-oceans-admin

verify-oceans-admin

Verified

Verify the Oceans LLM admin control plane and backend gateway against the real local stack, seeded demo data, and bounded live providers when required. Use for user-path checks of sign-in, models, API keys, observability, usage costs, spend controls, batches, agent sessions, request logs, Anthropic Messages thinking and effort compatibility, MCP registry and tool access, OpenRouter routing, guardrails, and Skills storage.

FileKindSize
SKILL.mdskill md29.0 KB
examples/mcp-candidates.jsonconfig3.0 KB
features/README.mdmarkdown10.0 KB
features/account-onboarding.mdmarkdown4.3 KB
features/agent-harnesses.mdmarkdown4.3 KB
features/agent-plugins.mdmarkdown1005 B
features/agent-sessions.mdmarkdown3.9 KB
features/anthropic-messages.mdmarkdown20.7 KB
features/api-keys.mdmarkdown6.5 KB
features/attribution.mdmarkdown13.9 KB
features/audit-log.mdmarkdown4.9 KB
features/backend-gateway.mdmarkdown5.2 KB
features/batch-requests.mdmarkdown4.2 KB
features/design-system.mdmarkdown4.6 KB
features/guardrails.mdmarkdown7.0 KB
features/harness-integration.mdmarkdown7.8 KB
features/identity.mdmarkdown4.2 KB
features/image-generation.mdmarkdown7.3 KB
features/leaderboard.mdmarkdown3.3 KB
features/live-llm-requests.mdmarkdown12.6 KB
features/mcp-client-oauth.mdmarkdown9.9 KB
features/mcp-ownership.mdmarkdown7.4 KB
features/mcp.mdmarkdown19.6 KB
features/models.mdmarkdown8.2 KB
features/password-sign-in.mdmarkdown8.3 KB
features/profile.mdmarkdown2.5 KB
features/rate-limits.mdmarkdown6.0 KB
features/request-logs.mdmarkdown8.6 KB
features/review-agent.mdmarkdown3.7 KB
features/routing.jsonconfig33.6 KB
features/service-tiers.mdmarkdown6.3 KB
features/skills.mdmarkdown9.8 KB
features/spend-controls.mdmarkdown7.3 KB
features/usage-costs.mdmarkdown3.7 KB
features/workspace-connections.mdmarkdown6.1 KB
scripts/check-messages.mjsexecutablescript2.4 KB
scripts/check-messages.test.mjsscript3.0 KB
scripts/control-oceans-adminexecutablescript25.3 KB
scripts/control-oceans-admin.test.mjsscript7.6 KB
scripts/drive-backend-gateway.mjsexecutablescript12.5 KB
scripts/drive-harness-integration.mjsscript6.6 KB
scripts/drive-mcp.mjsscript13.0 KB
scripts/drive-models.mjsscript12.9 KB
scripts/drive-observability.mjsscript16.8 KB
scripts/drive-profile.mjsscript8.2 KB
scripts/drive-service-tiers.mjsexecutablescript20.1 KB
scripts/drive-skills.mjsscript27.2 KB
scripts/mcp-browser.mjsscript26.5 KB
scripts/mcp-canary.mjsscript18.8 KB
scripts/mcp-candidates.mjsscript3.5 KB
scripts/mcp-verification.test.mjsscript10.2 KB
scripts/messages-regressions.mjsscript15.8 KB
scripts/plan-verification.mjsscript5.2 KB
scripts/plan-verification.test.mjsscript6.1 KB
scripts/proof-cli.mjsscript11.1 KB
scripts/proof.mjsscript9.2 KB
scripts/proof.test.mjsscript10.4 KB

features/review-agent.md

View on GitHub
# Review agent

Review Agent lets a platform administrator register a GitHub repository for automated pull-request reviews. The admin binds the repository to a service account, toggles review features, and generates the GitHub Actions workflow to commit. The page also lists recent review runs that the workflow reports back.

## Sub-features

- `review-repos-list` lists configured repositories with their service account, `N of 5 enabled`, last review, and status.
- `review-repo-create` adds a repository bound to a service account and opens its workflow setup.
- `review-repo-settings` edits the service account, the feature toggles, `Max inline comments`, and `Default model key`.
- `review-workflow` generates `.github/workflows/oceans-review-agent.yml` from `Action ref` and `API key secret name`.
- `review-repo-lifecycle` disables and reactivates a repository.
- `review-runs` lists recent runs and can filter them by repository.

## How to get to it (user POV)

- Under `Control Plane`, choose `Review Agent`. By default only platform admins are granted this page.
- Open `/admin/review-agent?repo_id=<id>&repo_section=overview|settings|setup` to land directly in `Manage repository`.

## Driving it with control-oceans-admin

Preconditions:

- `control-oceans-admin doctor` passes, and you are signed in as `admin@local`.
- The seeded service account `Local CI Runner` (Platform) is active.
- Use the repository name `verify-<run-id>` under the owner `oceans-verify`.

- **List.** Choose `Review Agent`. The `Review agent` heading shows `Repositories` and `Recent reviews`. With no repositories, the page shows `No repositories configured yet` and `Configure first repository`.
- **Create.** Choose `Add repository`, fill `Owner` and `Repository name`, pick `Local CI Runner (Platform)` in `Service account`, then choose `Configure repository`. The toast reads `Repository configured`, and `Manage repository` opens on `Workflow setup`.
- **Workflow.** `Generated workflow` shows YAML that names `.github/workflows/oceans-review-agent.yml` and the configured secret name. `Copy YAML` is present.
- **API parity.** Fetch `/api/v1/admin/review-agent/repositories`. The new repository appears with the same owner, name, and service account. Its row shows `3 of 5 enabled` and last review `Never`.
- **Settings.** In `Review settings`, set the `PR summary` toggle group to off, then choose `Save changes`. The toast reads `Repository updated`. Fetch the API again and check the row's feature count to confirm the change.
- **Runs.** Filter `Filter runs by repository` to the new repository. It shows `No review runs recorded yet.`, which matches `/api/v1/admin/review-agent/repositories/<id>/runs`.
- **Cleanup.** Under `Review settings` → `Lifecycle actions`, choose `Disable`. The toast reads `Repository disabled`, and both the row status and the API report it as disabled.
- **Proof.** Capture the create dialog, the workflow YAML (it contains no secrets), the updated toggle, and the disabled row.

## Gotchas

- This feature mutates `gateway.db`. There is no delete, so `Disable` is the cleanup and the record stays.
- Active repositories are unique by owner and name, case-insensitively. Always use a name that includes the run ID.
- Nothing calls GitHub. Runs appear only when a workflow posts to `/api/v1/review-agent/action/runs` with an API key, so an empty run list is expected.
- The `API key secret name` placeholder reads `OCEANS_API_KEY`, but the backend default is `OCEANS_REVIEW_AGENT_API_KEY`.
- Without an active service account, `No service accounts available` blocks creation.
- The backend accepts team owners and admins for their own team's accounts, but the default `gateway.yaml` grants the page only to platform admins.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall