bx-skills 1.0.0

TUI for installing AI coding assistant skills

bx_skills

Claude Skills

A collection of Claude Code skills for software engineering workflows.

Skills prefixed with bx- are custom-built or modified skills from one of the following sources :

• Vercel Agent Skills Directory
• Obra Superpowers Skill Library
• React/Next.js Performance Optimization
• Writing Clearly and Concisely
• Agentation
• Tailwind Design System
• UI/UX Pro Max

Installation

# install uv/uvx
python -m pip install --upgrade uv
# install bx-skills
uvx bx_skills@latest --help

CLI Usage

uvx bx-skills@latest --help                                        # Show help
uvx bx-skills@latest list                                          # Browse catalog
uvx bx-skills@latest list -q                                       # Machine-readable list
uvx bx-skills@latest status --target all --scope both              # Audit installed skills
uvx bx-skills@latest install --all --target claude-code            # Install all skills
uvx bx-skills@latest install bx-textual --target claude-code --scope project  # Install specific skill
uvx bx-skills@latest uninstall bx-textual --target claude-code -y  # Remove a skill
uvx bx-skills@latest info                                          # Version & metadata
uvx bx-skills@latest tui                                           # Launch interactive TUI

Auto-Update via Shell Alias

Bash

Add the following to ~/.bashrc to automatically sync skills before every claude session:

alias claude='uvx bx_skills@latest install --all -q && command claude'

Reload your shell or run source ~/.bashrc to activate.

Skills

Skill	Description
brainstorming	Turns ideas into fully formed designs and specs through collaborative dialogue. Explores user intent, requirements, and design before implementation.
bx-bash-clean-architecture	Framework-agnostic structured Bash architecture with layered ports-and-adapters pattern. Keeps domain pure and testable with inner layers never calling outer layers directly.
bx-bash-reference	Complete reference for GNU Bash 5.3 covering all shell syntax, builtins, variables, expansions, redirections, and features.
bx-enhance-code-quality	Scores a project 0-10, identifies issues by severity, and walks through fixes while respecting prior decisions documented in CLAUDE.md.
bx-python-clean-architecture	Framework-agnostic typed Python architecture with layered ports-and-adapters pattern. Keeps inner layers pure and independent of infrastructure.
bx-python-libraries-to-use	Standardized library choices for Python projects ensuring consistency and enforcing preferred tools over alternatives.
bx-uv	Complete reference for uv (v0.10.2) covering project setup, dependency management, virtual environments, Python versions, tools, Docker, CI/CD, and migration from pip.
executing-plans	Loads a written implementation plan and executes tasks in batches with checkpoints for architect review between batches.
force-using-skills	Establishes that skills must be invoked whenever applicable. If there is even a 1% chance a skill applies, it must be used.
systematic-debugging	Requires finding root cause before attempting fixes. Prevents random patches that mask underlying issues.
test-driven-development	Write tests first, watch them fail, then write minimal code to pass. Ensures tests validate the right behavior.
using-superpowers	Establishes how to find and use skills, requiring Skill tool invocation before any response when skills apply to the task.
verification-before-completion	Requires running verification commands and confirming output before making any success claims. Evidence before assertions.
writing-plans	Creates comprehensive implementation plans with bite-sized tasks, documenting which files to touch, testing strategies, and how to verify completion.
writing-skills	Applies TDD to process documentation by writing test cases, watching them fail, creating skill documentation, and verifying agents comply.