Skip to content

BuilderIO/agent-native / .agents/skills/agent-page

agent-page

Verified

The agent's configuration surfaces: Settings › Agent pages (Instructions, Memory, Skills, Files, Sub-agents) and the full-page `AgentTabsPage` (resources, Snapshots, Agent integrations, Automations, MCP). Use when adding an agent resource group, surfacing context transparency, MCP servers, A2A agents, recurring jobs, or external-client connect flows in the UI.

Agent Page

AgentTabsPage (from @agent-native/core/client, source packages/core/src/client/agent-page/) is the canonical full-page surface for everything that can influence the agent. Design principles:

  • The page answers "what can influence this agent, and why" — it is not a generic admin console.
  • Capability and access stay separate: Connections is what this agent can reach; Access is who can reach this agent.
  • It is a thin shell that re-hosts existing components (ResourcesPanel, MCP hooks, AgentsSection, context X-Ray, jobs actions) — do not re-implement those surfaces inside it.
  • Context must be inspectable, attributable, and governable — provenance and governance tiers, not just a token meter.

Tabs

defaultTab is files. Resource tabs re-host ResourcesPanel views; the rest re-host existing components.

TabContents
files, instructions, agents, memory, skills, learnings, remote-agentsResourcesPanel views (group "resources").
snapshotsScope preview, token budget, provenance-grouped system sections (governance tiers), and the latest live-thread snapshot. Backed by context-preview-get / context-manifest-get (see context-xray). Old #context links land here.
connections"Agent integrations": MCP server management (both scopes, admin-gated org writes).
jobsAutomations: personal and organization Scheduled/Event tasks with pause/resume/delete. The jobs hash is stable for compatibility (see automations and recurring-jobs).
settingsThe agent settings panel (model, keys, limits, voice).
access"MCP": copyable MCP URL and A2A agent-card URL, per-client connect steps from packages/core/src/shared/mcp-connect-content.ts (shared with /mcp/connect; edit the shared module, never fork copy), static-token fallback link.

Settings Resource Pages

Settings › Agent › Instructions, Memory, Skills, and Files (packages/core/src/client/settings/shell/pages/) render the same ResourcesPanel with settingsGroups: Personal, {Org name}, and From Dispatch groups (Memory swaps From Dispatch for Learnings). Add a group or an add action there, not a second panel. Row read-only state comes from the scope: organization rows for members and Dispatch rows for everyone; the server still enforces it. Resource trees refetch on action change events, which is how an agent's save-memory or resources write appears without a reload.

Settings › Agent › Sub-agents (pages/sub-agents.tsx) is the one place that lists every agent the main agent can hand work to, each once:

  • {Org} apps: first-party apps, from their seeded remote-agents/<id>.json manifests plus workspace apps only discovery knows, each "Reachable · {URL}" from the batched /_agent-native/agents/probe.
  • External agents: every other remote-agents/ manifest. The header's Connect agent (owners and admins) opens the directory dialog: Foundry, Gemini Enterprise, Anthropic Managed Agents, and any A2A agent by URL.
  • Custom agents: agents/*.md profiles through ResourcesPanel settingsGroups. Anyone can add a personal one.

Build on useRemoteAgents() and the AgentAddForm / AgentEditForm exports of AgentsSection.tsx, not a second fetch. ?connect=<a2a|anthropic-managed-agents|manual> and the peer register-back f_agent* params still open the connect form, and legacy ids (agent:agents, agent:directory, agent:resources:agents, agent:resources:remote-agents, section a2a) redirect to this page. Hidden and removed first-party ids (shared/first-party-agents.ts) stay unlisted, the same rule discovery applies.

Mounting In A Template

First-party templates don't mount AgentTabsPage. Their /agent route redirects into Settings with buildLegacyAgentSettingsRoute(hash, search), so /agent#files, #jobs, #connections, and #access land on the matching Settings page, and they pass agentPageHref="/settings/agent" to AgentSidebar (Settings › Agent › Model). New agent-configuration UI belongs on a Settings page, not a new tab here.

For an app that wants the whole surface on one page:

  1. Mount AgentTabsPage from @agent-native/core/client/agent-chat on its own route. CSR is fine; keep the app shell in root.tsx so navigation does not remount it (client-side-routing skill).
  2. Pass that route as agentPageHref to AgentSidebar.
  3. App-specific additions go in extraTabs (same SettingsTabItem shape as the settings page) or extraTabFactories; hide built-ins only with hiddenTabs when the app genuinely lacks the underlying capability.

Scope

The page currently passes personal scope (and canManageOrg) to tabs via AgentPageTabProps; it does not expose a page-level Personal/Organization toggle. A tab may render its own scoped sections where the underlying actions support them. The Automations tab shows personal and organization sections for both Scheduled and Event triggers. Organization event automations remain creator-run: administrators can manage them, but cannot retarget the creator's identity.

brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 319kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 196kUpdated Claude CodeCodexVerifiedInstall