Index of every page on this site: llms.txt
All skills
block avatar

/agent-builder

@77422a9
by Block Open Sourceblock/berd1.1k stars
137
Run it yourself

Create, edit, or inspect Berd agents/personas stored as Agent Markdown files with YAML frontmatter under ~/.agents/agents. Use when user needs to manage Berd agents or personas.

  • 1 file
  • 2.5 KB
  • Updated 3 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/block/berd/agent-builder

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈48 tokens for metadata: the name and description. ≈581 when used: this file.

Description uses 2.4% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈193 characters, or 2.4%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Agent Builder

Use this skill when managing Berd agents/personas in Agent Markdown format.

Storage

Agents are UTF-8 Markdown files with YAML frontmatter:

  • Global: ~/.agents/agents/<slug>.md
  • Project-local: <project>/.agents/agents/<slug>.md

Default to global unless the user asks for project-local. Use platform path APIs or shell-safe home expansion.

Format

Each agent is one .md file:

---
name: Agent Name
description: A concise summary of what this agent does
provider: optional-provider
model: optional-model
avatar: optional-avatar
---

Agent instructions here.

Required frontmatter keys are name and description. The description must be a trimmed, non-empty summary of what the agent does; never create or save an agent with a missing, blank, or placeholder description. If the user has not supplied enough context to write an accurate description, ask for one before saving. Preserve all other frontmatter keys when editing existing agents unless the user explicitly changes them. The Markdown body is the agent’s system prompt/persona instructions.

When writing or generating a description or body, do not assign the agent a gender or gendered pronouns unless the user asked for one. Use it/its or they/them for the agent, matching how it is framed (tool vs. character), or avoid pronouns; people the instructions describe get they/them. Preserve pronouns the user chose, in either direction.

Names and Slugs

For create/rename, require a trimmed name that is non-empty, ≤80 characters, and contains no / or \.

Derive <slug> from the name by lowercasing, replacing each non-ASCII alphanumeric run with -, collapsing/trimming -, truncating to 64 characters, and falling back to agent.

Write <slug>.md; on create collisions, use <slug>-2.md, <slug>-3.md, etc.

Workflow

When editing, read the existing file first. Resolve targets by exact path, frontmatter name, then slug filename. Ask only if multiple matches remain.

Prefer direct file edits over helper scripts. Do not require Python, Node, or another runtime unless the current repo already requires it.

After writing, verify that the file exists, frontmatter is valid, name and description are both trimmed and non-empty, and preserved metadata was not removed. Report the final path.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 77422a9. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 3 months ago
metadata
{
  "berdBundled": true
}

README badge

README badge for block/berd/agent-builder