# Agent Native Toolkit

Inventory and ownership rules for shared Agent-Native workspace UI.

- Repository: https://github.com/BuilderIO/agent-native (7579 stars)
- Category: Design
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add BuilderIO/agent-native --skill agent-native-toolkit -g -a claude-code -y`
Codex: `npx skills add BuilderIO/agent-native --skill agent-native-toolkit -g -a codex -y`
Cursor: `npx skills add BuilderIO/agent-native --skill agent-native-toolkit -g -a cursor -y`
Gemini CLI: `npx skills add BuilderIO/agent-native --skill agent-native-toolkit -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add BuilderIO/agent-native`

## Description

Inventory and ownership rules for shared Agent-Native workspace UI. Use before building app chrome, settings, navigation, sharing, collaboration, setup, history, comments, chat rails, agent UX, or repeated workspace behavior.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Agent-Native Toolkit

Use this skill when deciding whether app chrome, settings, collaboration,
sharing, navigation, organization, setup, history, comments, or agent UX should
be built app-locally or moved into reusable framework/toolkit pieces.

## Core Rule

Apps own domain models, domain actions, and product-specific workflows. The
framework and `@agent-native/toolkit` own repeated workspace behavior users
expect to work the same everywhere.

Move behavior into shared toolkit primitives when it is:

- workspace-wide, such as settings, nav, search, org membership, or setup
- agent-visible, such as context, actions, run progress, or proof-of-done
- governed, such as secrets, permissions, sharing, audit, or billing
- repeated by two or more apps
- not tied to one domain model

Keep behavior app-local when the abstraction would hide important domain
language or make a simple app-specific workflow harder to understand.

## Agent Surface Contract

When using the shared app shell, keep its two navigation surfaces distinct:

The rest: https://github.com/BuilderIO/agent-native/blob/HEAD/.agents/skills/agent-native-toolkit/SKILL.md