By BillBai
Better By Agent - portable agent skills and thin Claude Code adapters for clearer technical documentation workflows.
Improve Chinese technical writing so engineers can read it quickly and trust the meaning. Use when the user asks to polish, rewrite, clarify, simplify, de-jargon, make prose more natural, or improve readability for Chinese technical text, including design docs, specs, proposals, PR descriptions, issues, review comments, READMEs, postmortems, release notes, plans, or AI-generated drafts. Focus on preserving technical meaning while making the structure, logic, wording, and tone clearer.
Turn a markdown doc into a single, self-contained visual HTML page that is easy to skim and trustworthy to read. Supports single files and directories (generates one HTML with tab navigation). Use whenever the user wants to read, understand, clean up, summarize, or share AI-generated markdown — specs, OpenSpec change proposals, reference docs, architecture/design docs, RFCs, READMEs — especially when they say the docs are long, dense, full of AI boilerplate ("slop"), hard to skim, or "抓不住重点". Also use when the user wants to translate an English doc into natural Chinese, or asks to "把这个 md 可视化 / 转成 HTML / 去掉套话 / 翻译成中文 / 看懂这份文档". The page surfaces the key points up top, collapses the deep detail, draws Mermaid diagrams for flows/architecture, and keeps the original text one click away. It never rewrites the author's meaning. Prefer this skill over a plain markdown→HTML conversion whenever readability, de-slopping, summarization, or Chinese translation matters.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
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@bba
codex plugin marketplace add BillBai/bba
Then 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.md
Directory:
/visualize docs/
The generated example is checked in at examples/rate-limiting.html.
In Codex or another skill-aware agent, invoke the portable skill directly:
Use $doc-visualizer on examples/rate-limiting-source.md
MIT
npx claudepluginhub billbai/bba --plugin bbaHarness-native ECC operator layer - 67 agents, 271 skills, 92 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses
Comprehensive C4 architecture documentation workflow with bottom-up code analysis, component synthesis, container mapping, and context diagram generation
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Access thousands of AI prompts and skills directly in your AI coding assistant. Search prompts, discover skills, save your own, and improve prompts with AI.
Reliable automation, in-depth debugging, and performance analysis in Chrome using Chrome DevTools and Puppeteer
Comprehensive feature development workflow with specialized agents for codebase exploration, architecture design, and quality review