A portable agent-skills toolkit for coding workflows: reusable skills and adapters that help AI coding agents produce cleaner, clearer, more trustworthy work.
BBA is not one trick. It is a toolbox. Each piece targets a specific friction in agent-assisted development, and they share one bar: brief, beautiful, accurate.
Repository: https://github.com/BillBai/bba
/plugin marketplace add BillBai/bba
/plugin install bba@bbacodex plugin marketplace add BillBai/bbaThen open /plugins, choose the BBA marketplace, and install bba.
The canonical skills live in skills/<skill-name>/SKILL.md and follow the open Agent Skills shape: YAML frontmatter plus Markdown instructions and optional bundled resources. Agents that support this format can import or copy the skill folders directly.
| Type | Name | What it does |
|---|---|---|
| Skill | doc-visualizer |
Turn AI-generated markdown (specs, OpenSpec, reference, architecture docs) into a readable, self-contained visual HTML page — de-slopped, enriched with sourced detail, and translated to natural Chinese when the source is English. Supports single files and directories (generates one HTML with tab navigation). Always keeps the original one click away. |
| Skill | chinese-tech-plain-writing |
Improve Chinese technical writing across docs, PRs, issues, reviews, READMEs, release notes, and AI-generated drafts. Preserves technical meaning while making structure, logic, wording, and tone clearer. |
| Claude Code command | /visualize |
Convenience command that applies doc-visualizer to a markdown file and writes a self-contained HTML page next to the source. |
| Path | Purpose |
|---|---|
skills/ |
Portable skill source of truth. Keep reusable workflows here first. |
.claude-plugin/ |
Claude Code plugin and marketplace metadata. |
.codex-plugin/ |
Codex plugin metadata. |
.agents/plugins/marketplace.json |
Codex marketplace entry for installing this repo as a plugin source. |
commands/ |
Claude Code command adapters. These should stay thin wrappers over portable skills. |
examples/ |
Source and generated examples for checking skill output quality. |
Single file:
/visualize examples/rate-limiting-source.mdDirectory:
/visualize docs/The generated example is checked in at examples/rate-limiting.bba-doc-viz.html.
In Codex or another skill-aware agent, invoke the portable skill directly:
Use $doc-visualizer on examples/rate-limiting-source.md
- Brief — cut the slop, keep the signal.
- Beautiful — output you actually want to read.
- Accurate — never distort the source; additions are marked and sourced.
MIT