BuilderIO/agent-native / templates/analytics/.agents/skills/admin-surfaces
admin-surfaces
VerifiedUse when an admin asks about feature flags and rollouts, dashboard usage stats, or connecting another app's database (the /agents admin home for Analytics).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.0 KB |
SKILL.md
View on GitHub---
name: admin-surfaces
description: >-
Use when an admin asks about feature flags and rollouts, dashboard usage stats, or connecting another app's database (the /agents admin home for Analytics).
---
# Admin Surfaces (`/agents`)
`/agents` is the Analytics home for admin surfaces. The default Monitoring
view embeds the shared observability dashboard for traces, conversations,
evals, agent experiments, and feedback.
## Feature Flags (`?view=flags`)
`/agents?view=flags` is the sole admin-only fleet feature-flag control plane.
- Call `list-workspace-feature-flags` before changing a flag.
- Preserve each app's explicit state: `unsupported`, `unreachable`,
`forbidden`, and `unknown-legacy` are unknown states, **never** synonyms for
off. Do not collapse them to a disabled toggle.
- Use `set-workspace-feature-flag` for app-qualified changes; target apps
remain the source of truth and are resolved only through the trusted
organization directory.
- A change writes this organization's rule unless the admin asks for every
organization; then pass `scope: "global"`. An organization's own rule
replaces the global rule, so read the flag's `scopes.inEffect` before saying
who a global change reaches.
- Treat only a versioned mutation response whose key, `scope.kind`, and
requested rules match as success. Report a failed target mutation instead
of claiming the rollout changed.
- Flags are source-declared booleans; do not create variants, metrics,
exposure tracking, or per-app management panels.
## Dashboard Usage (`?view=dashboards`)
`/agents?view=dashboards` shows the admin-only dashboard usage audit. Call
`list-dashboard-usage-stats` when admins ask about dashboard created/modified
dates, owners, last tracked modifier, views, edits, engagements, saved views,
or cleanup candidates. The dashboard overflow menu shows created/updated
timestamps and their tracked actors for both SQL and Explorer dashboards.
## Connected Database Admin (`?view=database`)
The Advanced menu opens `/agents?view=database`, where organization
owners/admins can connect other agent-native app databases and use the
shared database admin tool for table browsing, row editing, and SQL
inspection. This surface is for connected target app databases, not broad
access to all Analytics data.
Keep future admin additions inside this route instead of adding many
top-level sidebar tabs.
## Outside-Agent BigQuery Budgets
BigQuery jobs that connected MCP agents start count against daily limits:
$1 per person without asking, a $5 person ceiling, $50 per organization, and
50 GB per job, resetting at 00:00 UTC. Analytics' own agent and dashboards are
not limited. When an owner or admin asks to raise or reset a limit, call
`set-bigquery-agent-budget` (`scope` `org` or `person`, `dailyLimitUsd`, `null`
for the default) and report the limits it returns.
## Related Skills
- Root **feature-flags** (dev-scope) — how to declare and register a flag in
app code; this skill covers only the Analytics fleet control-plane UI/actions.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |