Agent skill · luongnv89
cli-builder
Build production-quality CLIs with language detection and a five-step approval-gated workflow. Use when wrapping an existing module or app. Don't use for GUI/TUI apps, web APIs, or one-off shell scripts.
What it needs
About 6k tokens when loaded.
What this skill does
CLI Builder Build production-quality CLI tools for any module or application, in any language. Reference files (read on demand, not upfront): references/cli-libraries.md — read during Step 2 (Design) to recommend libraries and during Step 4 (Execute) for starter scaffolds references/testing-patterns.md — read during Step 4 (Execute) when writing tests Repo Sync Before Edits (mandatory) Before creating/updating/deleting files in an existing repository, sync the current branch with remote: If the working tree is not clean, stash first, sync, then restore: If origin is missing, pull is unavailable, or rebase/stash conflicts occur, stop and ask the user before continuing. Branch-First Safety Rule Before changing any file, check the current branch. Only create a new branch if on main or master — otherwise continue on the existing branch (the user likely set it up already or is resuming work): Mandatory 5-Step Workflow (approval-gated) Step 1: Analyze Understand the project before proposing anything. Auto-detect language by checking for manifest files: package.json / tsconfig.json -> JavaScript/TypeScript pyproject.toml / setup.py / setup.cfg / requirements.txt -> Python go.mod -> Go Cargo.toml -> Rust pom.xml / build.gradle / build.gradle.kts -> Java/Kotlin Gemfile / .gemspec -> Ruby Identify existing CLI/entry points: check for bin fields, main.py, main.go, fn main(), existing arg parsing code, or scripts in package.json. Understand module structure: public API, core functions, data types, dependencies. Ask clarifying questions (only what cannot be inferred): Primary use case (automation, developer tool, data processing, admin) Target audience (developers, ops, end users) Single command or multi-command (subcommand tree) Output formats needed (text, JSON, table, CSV) Distribution method (pip/npm/go install, standalone binary, source) Present findings and wait for approval before proceeding. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills luongnv89/cli-builder