Agent skill

Build Agent

by chmonitor in chmonitor/chmonitor

Build an AI-agent application end-to-end — from an empty repo or an existing codebase.

GPL-3.0Auto-check passedAI & LLM Engineering

Install Build Agent

skills CLI
$ npx skills add chmonitor/chmonitor --skill build-agent -a claude-code

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

GitHub CLI
$ gh skill install chmonitor/chmonitor build-agent --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/chmonitor/chmonitor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/build-agent .claude/skills/build-agent && 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
build-agent
GitHub stars
299
Token cost
~1.8k tokens
SKILL.md length
789 words
Files
19 (incl. references)
Skills in repo
53
Repo updated
First seen
Licence
GPL-3.0

At a glance

Build an AI-agent application end-to-end — from an empty repo or an existing codebase.

  • Works in 5 steps: Determine the entry mode → Interview deeply (when in Interview mode) → Choose the framework → …
  • The user wants to build an agent
  • SKILL.md covers Operating principle: verify…, Step 1 — Determine the entry…, Step 2 — Interview deeply… and Step 3 — Choose the framework, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Build Agent is an agent skill from chmonitor/chmonitor. Build an AI-agent application end-to-end — from an empty repo or an existing codebase. Use when the user wants to "build an agent", "scaffold an agent app", "add an agent API", "build an agent UI/chat", "pick an agent framework", or set up tool calling, tracing, or an AI gateway. Interviews the user when requirements are unclear; detects the stack when a project already exists. Knows LangGraph, DeepAgents, Vercel AI SDK, Cloudflare Agents SDK, TanStack AI, Google ADK, and the Claude Agent SDK. Always verifies…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files, including reference files (for example `references/README.md`, `references/concepts/ai-gateways.md` and `references/concepts/skills.md`).

It sits in AI & LLM Engineering, covering Building AI agents, AI search optimization and Structured output and tool calling. It works with Claude Agent SDK, LangGraph, Vercel AI SDK and Cloudflare. The repository describes itself as: Open-source operational advisor for ClickHouse — real-time monitoring plus AI-driven index/partition/materialized-view recommendations. The licence is GPL-3.0.

When your agent uses it

  • The user wants to build an agent
  • Scaffold an agent app
  • Add an agent API
  • Build an agent UI/chat

Example prompts

  • “build an agent”
  • “scaffold an agent app”
  • “add an agent API”
  • “/build-agent”

Requirements

  • Python 3
  • Docker

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Determine the entry mode
  2. Interview deeply (when in Interview mode)
  3. Choose the framework
  4. Scaffold
  5. Agent-engineering concepts

What it can do on your machine

Read from SKILL.md and the folder at commit fc39ef0. 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

Build Agent loads about 1.8k tokens when it runs, and up to ~7.3k if it reads all its reference files. Until then it costs about 152 tokens; SKILL.md has 789 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~152
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.3k

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from chmonitor/chmonitor at commit fc39ef0, republished under its GPL-3.0 licence (© chmonitor). 789 words, ~1,764 tokens.

Download SKILL.mdSave it as .claude/skills/build-agent/SKILL.md (or your agent's skills folder). This skill also uses 18 other files; get the full folder from GitHub.
name
build-agent
description
Build an AI-agent application end-to-end — from an empty repo or an existing codebase. Use when the user wants to "build an agent", "scaffold an agent app", "add an agent API", "build an agent UI/chat", "pick an agent framework", or set up tool calling, tracing, or an AI gateway. Interviews the user when requirements are unclear; detects the stack when a project already exists. Knows LangGraph, DeepAgents, Vercel AI SDK, Cloudflare Agents SDK, TanStack AI, Google ADK, and the Claude Agent SDK. Always verifies against live official docs (Context7 / llms.txt / WebFetch) before writing code.

build-agent

Scaffold and grow AI-agent applications. This skill is stack-agnostic: it helps you choose a framework, then builds the agent loop, tools, API surface, UI, observability, and deployment to match the user's real requirements.

Operating principle: verify before you build

Agent frameworks move fast. Never rely on memory for framework APIs. Before writing framework code, pull live docs in this order:

  1. Context7 MCP (if available) — resolve-library-id → query-docs.
  2. Official llms.txt / llms-full.txt / .md via WebFetch — see references/frameworks/* for the canonical URLs.
  3. The installed package itself — read node_modules/<pkg> or the Python package source; the user's pinned version is the source of truth.

The references/ tree here is a thin glossary + link index, deliberately kept small so it does not go stale. It tells you what exists and where the real docs are — not the full API. Treat any code snippet in references as illustrative, then confirm against live docs.

If the host agent already has Context7, WebSearch, zread, or a relevant skill — use it. Don't reinvent retrieval.

Step 1 — Determine the entry mode

Decide which of these you're in, then jump to the matching workflow:

SituationModeWorkflow
Empty/near-empty repo, or user says "from scratch"Interviewworkflows/from-scratch.md
Existing project with codeDetectworkflows/from-existing.md
User explicitly asks to (re)interviewInterviewworkflows/from-scratch.md

Quick check: list the repo, look for package.json / pyproject.toml / wrangler.jsonc / go.mod. Nothing meaningful → Interview. Something there → Detect the techstack first, confirm it with the user, then only ask what the code can't answer.

Step 2 — Interview deeply (when in Interview mode)

Use the host's ask-user tool. Don't ask one shallow question — gather as much as possible across these dimensions. Follow workflows/from-scratch.md for the full question bank. Cover at minimum:

  • Purpose / use case — what should the agent do? (RAG assistant, coding agent, workflow automation, customer support, research, multi-agent system…)
  • Language — TypeScript / Python / Go / other.
  • Framework — see the chooser below; recommend, don't impose.
  • Architecture — single agent, supervisor/multi-agent, graph/state machine, human-in-the-loop, durable/long-running, streaming vs batch.
  • Model + provider — Claude / GPT / Gemini / open models; direct or via a gateway (OpenRouter / AnyRouter / AI gateway).
  • Tools / integrations — what external actions (search, code exec, DB, MCP servers, APIs) the agent needs.
  • UI/UX — chat UI, dashboard, headless API only, CLI, embedded widget.
  • Persistence / memory — conversation state, vector store, checkpointing.
  • Observability — tracing, evals, cost/latency tracking (see references/concepts/tracking-observability.md).
  • Deploy target — Docker, VM, k3s/Kubernetes, a cloud (AWS/GCP/Azure), Cloudflare Workers, Vercel, serverless.

Restate the assembled requirements back to the user before scaffolding.

Step 3 — Choose the framework

Match the dominant requirement to a framework. Full notes in references/frameworks/.

If the user wants…Lean towardLang
Stateful graphs, supervisor/multi-agent, human-in-loop, checkpointingLangGraphPy / TS
Opinionated "deep" planning agent (subagents, file tools, todo) on top of LangGraphDeepAgentsPy / TS
Web app with streaming chat, tool calls, generative UI; Next.js/ReactVercel AI SDKTS
Edge-native, durable, stateful agents that scale to zeroCloudflare Agents SDK (Durable Objects)TS
Provider-agnostic, type-safe streaming/tools/structured output in any TS appTanStack AITS
Google-ecosystem, Gemini-first, code-first multi-agent with eval toolingGoogle ADKPy / Java
Build on the same harness Claude Code uses; subagents, MCP, hooks, permissionsClaude Agent SDKPy / TS

Mixed needs are common (e.g. LangGraph backend + AI SDK frontend, or Claude Agent SDK behind a Cloudflare Worker). Compose; don't force one box.

Show full SKILL.md (254 more words)Show less

Step 4 — Scaffold

Build the minimum that runs, then layer on. Match the chosen framework's conventions exactly — pull its quickstart from live docs first.

Typical layers (build only what the requirements call for):

  1. Agent core — the loop / graph / state. Confirm the current API shape.
  2. Tools — define and wire tool calls. See references/concepts/tool-calling.md.
  3. Model access — direct provider or gateway. See references/concepts/ai-gateways.md for OpenRouter / AnyRouter / AI gateway.
  4. API surface — HTTP/streaming endpoints, or MCP server, per deploy target.
  5. UI/UX — chat or dashboard. For React, prefer the framework's own UI primitives (AI SDK UI / AI Elements, Assistant UI, TanStack). For design quality, defer to the host's frontend-design skill if present.
  6. Persistence & memory — checkpointer / store / vector DB.
  7. Observability — tracing + evals + cost tracking from day one.
  8. Deploy — Dockerfile / wrangler / k8s manifests / cloud config for the chosen target.

After each layer: make it run, verify, then continue. Fail loud if a step is skipped.

Step 5 — Agent-engineering concepts

These cut across frameworks — read the matching reference when relevant:

  • Building skills for agents → references/concepts/skills.md
  • Tool calling (schemas, validation, parallel calls, MCP) → references/concepts/tool-calling.md
  • Tracking / observability (traces, evals, cost) → references/concepts/tracking-observability.md
  • AI gateways (OpenRouter, AnyRouter, AI gateway, BYOK) → references/concepts/ai-gateways.md
  • Model-specific prompting → references/engineering/{claude,gemini,gpt}.md

Guardrails

  • Don't pick a framework silently — recommend with a one-line why, let the user decide.
  • Don't embed stale API code — verify against live docs first.
  • Build the smallest thing that runs before expanding.
  • Keep secrets out of the repo; use env vars / the platform's secret store.
  • Match the existing codebase's conventions when in Detect mode.

© chmonitor, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 18 other files (references) in .agents/skills/build-agent of chmonitor/chmonitor.

  • SKILL.md
  • references/README.md
  • references/concepts/ai-gateways.md
  • references/concepts/skills.md
  • references/concepts/tool-calling.md
  • references/concepts/tracking-observability.md
  • references/engineering/claude.md
  • references/engineering/gemini.md
  • references/engineering/gpt.md
  • references/frameworks/ai-sdk.md
  • references/frameworks/claude-agent-sdk.md
  • references/frameworks/cloudflare-agents.md
  • references/frameworks/deepagents.md
  • references/frameworks/google-adk.md
  • references/frameworks/langgraph.md
  • references/frameworks/tanstack-ai.md
  • workflows
  • … and 2 more

Open the folder on GitHubat commit fc39ef0

Compare with similar skills

Build Agent 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.

Build Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Build Agent this skillchmonitor/chmonitor299—~1.8kAutomated safety check: PassGPL-3.0
AI SDKvercel-labs/ai-facts16821 repos~1.2kAutomated safety check: PassNone
Failproof AI SDK IntegrationFailproofAI/failproofai5.3k—~6kAutomated safety check: PassCustom licence
Edgeone Makers MigrationTencentEdgeOne/edgeone-makers-tools1.9k1 repos~4.1kAutomated safety check: PassMIT
Edgeone Makers AgentsTencentEdgeOne/edgeone-makers-tools1.9k1 repos~5.8kAutomated safety check: NotesMIT
LangGraph Decision Modelslangchain-ai/langchain-skills1.3k—~2.3kAutomated safety check: PassMIT

Similar skills

  • AI SDK

    vercel-labs/ai-facts

    Official

    Answer questions about the AI SDK and help build AI-powered features.

    168 GitHub starsUsed in 21 repos~1.2k tokens
    AI & LLM EngineeringAuto-check passed
  • Failproof AI SDK Integration

    FailproofAI/failproofai

    Helps instrument a custom Python or TypeScript agent to record events for Failproof AI, verify what gets written, and run an evaluator worker that scores the runs.

    5.3k GitHub stars~6k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Edgeone Makers Migration

    TencentEdgeOne/edgeone-makers-tools

    Migrate existing AI agent projects (LangChain, LangGraph, OpenAI Agents SDK, Claude Agent SDK, CrewAI) to EdgeOne Makers platform conventions.

    1.9k GitHub starsUsed in 1 repo~4.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Edgeone Makers Agents

    TencentEdgeOne/edgeone-makers-tools

    This skill guides building AI agent endpoints on EdgeOne Makers — five framework routes (DeepAgents, LangGraph, CrewAI, OpenAI Agents SDK, Claude Agent SDK), platform-injected context.store /…

    1.9k GitHub starsUsed in 1 repo~5.8k tokens
    AI & LLM EngineeringAuto-check: notes
  • LangGraph Decision Models

    langchain-ai/langchain-skills

    Official

    Routes LangGraph agents with typed decision models that return probabilities, and finds LLM calls that only exist to produce a routing decision.

    1.3k GitHub stars~2.3k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Tool Design

    agentailor/fullstack-langgraph-nextjs-agent

    Design and verify tools that AI agents can actually use — for any framework or language (MCP servers, LangChain/LangGraph, function-calling, raw JSON schema; TypeScript, Python, or otherwise).

    132 GitHub stars~3.2k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed

More from chmonitor/chmonitor

All 53 skills in this repo
  • Hyperframes Creative

    chmonitor/chmonitor

    Non-animation creative direction for HyperFrames videos. An agent skill from chmonitor/chmonitor.

    299 GitHub starsUsed in 5 repos~1.3k tokens
    Auto-check passed
  • Hyperframes Media

    chmonitor/chmonitor

    Audio and media assets for HyperFrames compositions, produced by one shared audio engine (scripts/audio.mjs) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound…

    299 GitHub starsUsed in 1 repo~2.8k tokens
    Auto-check: notes
  • Remotion To Hyperframes

    chmonitor/chmonitor

    Port an existing Remotion (React) composition to HyperFrames HTML.

    299 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Music To Video

    chmonitor/chmonitor

    A skill your agent uses when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting.

    299 GitHub starsUsed in 1 repo~4k tokens
    Auto-check: notes
  • Hyperframes Animation

    chmonitor/chmonitor

    All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus…

    299 GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • Faceless Explainer

    chmonitor/chmonitor

    turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video, up to ~3 min (sweet spot 30-90s), where every visual is invented (typography, abstract graphics…

    299 GitHub stars~4.5k tokensUpdated 2 days ago
    Auto-check: notes

Questions about Build Agent

What does Build Agent do?

Build an AI-agent application end-to-end — from an empty repo or an existing codebase. Build Agent is an agent skill from chmonitor/chmonitor. Build an AI-agent application end-to-end — from an empty repo or an existing codebase.

When should I use Build Agent?

Build Agent fits situations like: the user wants to build an agent; scaffold an agent app; add an agent API; build an agent UI/chat.

How do I install Build Agent in Claude Code?

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

How do I install Build Agent in Codex?

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

Can I use Build Agent 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 chmonitor/chmonitor --skill build-agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/build-agent, .gemini/skills/build-agent, .github/skills/build-agent and .opencode/skills/build-agent in your project.

What does Build Agent need to run?

SKILL.md names no scripts, command-line tools or credentials: Build Agent is instructions for the agent only. Our summary lists: Python 3; Docker.

Does Build Agent 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 Build Agent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Build Agent use?

Build Agent is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Build Agent use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.5k tokens, read only when the agent opens those files.

What are the alternatives to Build Agent?

Skills that share tags, products or a category with Build Agent: AI SDK (vercel-labs/ai-facts, 168 stars), Failproof AI SDK Integration (FailproofAI/failproofai, 5.3k stars), Edgeone Makers Migration (TencentEdgeOne/edgeone-makers-tools, 1.9k stars) and Edgeone Makers Agents (TencentEdgeOne/edgeone-makers-tools, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Build Agent?

chmonitor (a GitHub organization) maintains it in chmonitor/chmonitor, which has 299 GitHub stars. The repository holds 53 skills in this directory. The repository was last updated on October 5, 2026.

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