Agent skill

Workspace Conventions

by BuilderIO in BuilderIO/agent-native

Shared conventions for a multi-app Agent-Native workspace: finding version-matched framework docs and source, shared vs app-owned code, file and blob storage, env and secrets, agent scratch files…

No licenceAuto-check: notesBackend & APIs

Install Workspace Conventions

skills CLI
$ npx skills add BuilderIO/agent-native --skill workspace-conventions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BuilderIO/agent-native workspace-conventions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BuilderIO/agent-native.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/workspace-conventions .claude/skills/workspace-conventions && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
workspace-conventions
GitHub stars
7.1k
Token cost
~1.5k tokens
SKILL.md length
704 words
Files
1
Skills in repo
102
Repo updated
First seen
Licence
None found

At a glance

Shared conventions for a multi-app Agent-Native workspace: finding version-matched framework docs and source, shared vs app-owned code, file and blob storage, env and secrets, agent scratch files…

  • Working across workspace apps
  • SKILL.md covers Framework Docs Lookup, Shared Conventions and Related Skills
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Looking up framework APIs

What it does

Workspace Conventions is an agent skill from BuilderIO/agent-native. Shared conventions for a multi-app Agent-Native workspace: finding version-matched framework docs and source, shared vs app-owned code, file and blob storage, env and secrets, agent scratch files, and Dispatch Resources. Use when working across workspace apps, storing files or credentials, or looking up framework APIs.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering File uploads and storage. It works with Azure Blob Storage. The repository describes itself as: A framework for building agentic apps.

When your agent uses it

  • Working across workspace apps
  • Looking up framework APIs

Example prompts

  • “/workspace-conventions”

What it can do on your machine

Read from SKILL.md and the folder at commit e16da0c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Workspace Conventions loads about 1.5k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 704 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:57
    ime configuration in the workspace root `.env`; use
  • NoteMentions a .env fileSKILL.md:58
    `apps/<app>/.env` only for app-specific overrides. For public app behavior,

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 704 words (~1,516 tokens).

“The long-form detail behind the workspace AGENTS.md core rules. Read this before adding shared code, storing files or secrets, creating workspace resources, or looking up framework APIs.”

— opening of SKILL.md by BuilderIO
name
workspace-conventions
scope
dev

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/workspace-conventions of BuilderIO/agent-native.

Open the folder on GitHubat commit e16da0c

Compare with similar skills

Workspace Conventions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Workspace Conventions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workspace Conventions this skillBuilderIO/agent-native7.1k—~1.5kAutomated safety check: NotesNone
Edgeone Makers StorageTencentEdgeOne/edgeone-makers-tools1.9k1 repos~930Automated safety check: PassMIT
Azure Storage Blob Javamicrosoft/skills3.1k6 repos~2.7kAutomated safety check: PassMIT
Azure Storage Blob TSmicrosoft/skills3.1k6 repos~3.3kAutomated safety check: PassMIT
Neon Object Storageneondatabase/agent-skills100—~3.5kAutomated safety check: NotesApache-2.0
Azure Storage Blob Pymicrosoft/skills3.1k—~2.3kAutomated safety check: PassMIT

Similar skills

  • Edgeone Makers Storage

    TencentEdgeOne/edgeone-makers-tools

    KV and Blob storage services on EdgeOne Makers. An agent skill from TencentEdgeOne/edgeone-makers-tools.

    1.9k GitHub starsUsed in 1 repo~930 tokens
    Backend & APIsAuto-check passed
  • Azure Storage Blob Java

    microsoft/skills

    Official

    Build blob storage applications with Azure Storage Blob SDK for Java.

    3.1k GitHub starsUsed in 6 repos~2.7k tokens
    Backend & APIsAuto-check passed
  • Azure Storage Blob TS

    microsoft/skills

    Official

    Azure Blob Storage JavaScript/TypeScript SDK (@azure/storage-blob) for blob operations.

    3.1k GitHub starsUsed in 6 repos~3.3k tokens
    Backend & APIsAuto-check passed
  • Neon Object Storage

    neondatabase/agent-skills

    Official

    S3-compatible object storage that branches with your Neon project, so files and the database stay in sync across every branch.

    100 GitHub stars~3.5k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Azure Storage Blob Py

    microsoft/skills

    Official

    Azure Blob Storage SDK for Python. An agent skill from microsoft/skills.

    3.1k GitHub stars~2.3k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Azure Storage Blob Rust

    microsoft/skills

    Official

    Azure Blob Storage library for Rust. An agent skill from microsoft/skills.

    3.1k GitHub stars~2.7k tokensUpdated yesterday
    Backend & APIsAuto-check passed

More from BuilderIO/agent-native

All 102 skills in this repo
  • Actions

    BuilderIO/agent-native

    How to create and run agent actions. An agent skill from BuilderIO/agent-native.

    7.1k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Client Methods

    BuilderIO/agent-native

    Client method surface rules. An agent skill from BuilderIO/agent-native.

    7.1k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Adding A Feature

    BuilderIO/agent-native

    The four-area checklist every new feature must complete. An agent skill from BuilderIO/agent-native.

    7.1k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Address Feedback

    BuilderIO/agent-native

    Triage feedback from docs, issues, Slack threads, or pasted notes into verified bugs, UX proposals, unclear questions, and skipped noise.

    7.1k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Audit Log

    BuilderIO/agent-native

    Durable, access-scoped, append-only record of who changed what app data, when, and whether it was the agent or a human.

    7.1k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Automations

    BuilderIO/agent-native

    Event-triggered and schedule-triggered automations with natural-language conditions.

    7.1k GitHub stars~4.4k tokensUpdated today
    Auto-check passed

Categories

Questions about Workspace Conventions

What does Workspace Conventions do?

Shared conventions for a multi-app Agent-Native workspace: finding version-matched framework docs and source, shared vs app-owned code, file and blob storage, env and secrets, agent scratch files…. Workspace Conventions is an agent skill from BuilderIO/agent-native. Shared conventions for a multi-app Agent-Native workspace: finding version-matched framework docs and source, shared vs app-owned code, file and blob storage, env and secrets, agent scratch files, and Dispatch Resources.

When should I use Workspace Conventions?

Workspace Conventions fits situations like: working across workspace apps; looking up framework APIs.

How do I install Workspace Conventions in Claude Code?

Run `npx skills add BuilderIO/agent-native --skill workspace-conventions -a claude-code`. Or copy the skill folder (.agents/skills/workspace-conventions in BuilderIO/agent-native) into .claude/skills/workspace-conventions in your project. Claude Code loads it when a task matches its description.

How do I install Workspace Conventions in Codex?

Run `npx skills add BuilderIO/agent-native --skill workspace-conventions -a codex`. Or copy the skill folder (.agents/skills/workspace-conventions in BuilderIO/agent-native) into .agents/skills/workspace-conventions in your project. Codex loads it when a task matches its description.

Can I use Workspace Conventions in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BuilderIO/agent-native --skill workspace-conventions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workspace-conventions, .gemini/skills/workspace-conventions, .github/skills/workspace-conventions and .opencode/skills/workspace-conventions in your project.

What does Workspace Conventions need to run?

SKILL.md names no scripts, command-line tools or credentials: Workspace Conventions is instructions for the agent only.

Does Workspace Conventions access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Workspace Conventions safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Workspace Conventions use?

No licence was found for Workspace Conventions or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Workspace Conventions use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Workspace Conventions?

Skills that share tags, products or a category with Workspace Conventions: Edgeone Makers Storage (TencentEdgeOne/edgeone-makers-tools, 1.9k stars), Azure Storage Blob Java (microsoft/skills, 3.1k stars), Azure Storage Blob TS (microsoft/skills, 3.1k stars) and Neon Object Storage (neondatabase/agent-skills, 100 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workspace Conventions?

BuilderIO (a GitHub organization) maintains it in BuilderIO/agent-native, which has 7,087 GitHub stars. The repository holds 102 skills in this directory. The repository was last updated on October 8, 2026.

Source: BuilderIO/agent-native on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.