mirror of https://github.com/langbot-app/LangBot.git synced 2026-06-22 13:34:24 +00:00

Files

T

huanghuoguoguo 73be17b02c test(qa): record claude-code-agent skill discovery PASS + acp transport finding

- claude-code-agent (new pipeline, remote-ssh->101): langbot_list_assets returns
  skills=1 tools=15 in 24s -> all-tool 'skills' asset class is discoverable
  end-to-end by an external harness on the unmodified branch
- document the runner transport difference: claude-code uses a stdio bridge
  (works on remote-ssh out of the box), acp uses an HTTP proxy (needs
  langbot-assets-gateway-public-url on remote-ssh). This is a runner-plugin
  detail, not a host all-tool-branch issue

2026-06-22 08:16:35 +08:00

qa-agent-docs

feat: MCP server + in-repo skills (agent-friendly platform) (#2269 )

2026-06-20 15:14:47 +08:00

schemas

feat: MCP server + in-repo skills (agent-friendly platform) (#2269 )

2026-06-20 15:14:47 +08:00

scripts

fix(skills): bootstrap generated lbs wrapper (#2270 )

2026-06-20 17:24:04 +08:00

skills

test(qa): record claude-code-agent skill discovery PASS + acp transport finding

2026-06-22 08:16:35 +08:00

src

fix(skills): bootstrap generated lbs wrapper (#2270 )

2026-06-20 17:24:04 +08:00

test

fix(skills): bootstrap generated lbs wrapper (#2270 )

2026-06-20 17:24:04 +08:00

.gitignore

feat: MCP server + in-repo skills (agent-friendly platform) (#2269 )

2026-06-20 15:14:47 +08:00

AGENTS.md

fix(skills): bootstrap generated lbs wrapper (#2270 )

2026-06-20 17:24:04 +08:00

package.json

fix(skills): bootstrap generated lbs wrapper (#2270 )

2026-06-20 17:24:04 +08:00

README.md

fix(skills): bootstrap generated lbs wrapper (#2270 )

2026-06-20 17:24:04 +08:00

skills.index.json

feat: MCP server + in-repo skills (agent-friendly platform) (#2269 )

2026-06-20 15:14:47 +08:00

README.md

LangBot Skills

This directory is the single source of truth for LangBot's agent skills — reusable, on-demand instruction packs for AI agents (Claude Code, Codex, Cursor, and LangBot's own Local Agent) working with the LangBot ecosystem.

These skills were consolidated here from the former langbot-app/langbot-skills repository (now archived). Documentation and the landing page link here; do not re-copy skill content elsewhere — link to this directory instead.

Skill catalog

Skill	What it covers
`langbot-dev`	Core backend + web frontend development (Quart, Vite, API, migrations, MCP server)
`langbot-plugin-dev`	Plugin SDK / component development, debugging, WebSocket testing
`langbot-deploy`	Docker / Compose / Kubernetes deployment, config.yaml, Box runtime, global API key
`langbot-testing`	WebUI / e2e QA harness, cases, fixtures, troubleshooting (the `bin/lbs` CLI)
`langbot-env-setup`	Local dev/test environment, browser access, OAuth, proxy, startup
`langbot-mcp-ops`	Operating a LangBot instance through its MCP server (`/mcp`)
`langbot-space-ops`	Browsing the LangBot Space marketplaces through the Space MCP server
`langbot-eba-adapter-dev`	Building platform adapters for the Event-Based Agents architecture
`langbot-skills-maintenance`	Adding, deduplicating, and auditing skills in this directory

skills.index.json is the machine-readable index (regenerate with bin/lbs index).

Quick start (for an AI agent)

Read this README, AGENTS.md, and qa-agent-docs/ to understand the layout.
Read skills/.env for shared local defaults. On a new machine, copy skills/.env.example to skills/.env.local (gitignored) and override machine-specific values there. Never commit secrets.
Pick the smallest relevant skill from the catalog above and follow its SKILL.md.

The `lbs` CLI

The testing assets ship with a small CLI (bin/lbs, Node >= 22.6). The bin/lbs wrapper is a generated local entrypoint; on a fresh checkout, run npm run bootstrap once if it is missing. npm install also regenerates it via the prepare script.

npm run bootstrap    # create bin/lbs if missing
bin/lbs validate     # validate skills/cases/troubleshooting structure
bin/lbs index        # regenerate skills.index.json
bin/lbs env show     # inspect resolved env defaults (redacted)
bin/lbs env doctor   # diagnose local environment readiness
bin/lbs case list --ready
bin/lbs test plan <case-id>

Maintenance rule

When the LangBot / LangBot Space API or MCP server changes, the corresponding skill here MUST be updated in the same change. The MCP tool surface, the API, and these skills are kept in lockstep — see each repo's AGENTS.md.

README.md

LangBot Skills

Skill catalog

Quick start (for an AI agent)

The lbs CLI

Maintenance rule

The `lbs` CLI