dx-harness
DX Harness
Every project benefits from an internal CLI that wraps common workflows into repeatable, discoverable commands. This skill guides two things:
- Building the dx package — an internal CLI tool that lives in the repo
- Creating the dx skill — a project-level AI skill that documents the CLI so agents can use it effectively
The dx harness serves both humans (tab completion, help text, consistent interface) and AI agents (structured commands that replace fragile multi-step shell invocations). When an agent can run bun dx test convex instead of figuring out the right combination of flags, working directories, and environment variables, reliability goes up dramatically.
Part 1: The DX Package
What It Is
A CLI tool that lives inside the project repository, typically at apps/dx/ or tools/dx/ or cmd/dx/ depending on language conventions. It wraps internal workflows — dev servers, testing, database operations, deployment, data pipelines — into a single entry point.
The name "dx" stands for developer experience. Some projects alias it to a project abbreviation too (e.g., bun sv for StreamerVerdict). The key idea: one command to rule them all.
When to Create One
More from derek-x-wang/skills
life-os
>
10convex
Build full-stack TypeScript applications with Convex - a reactive backend-as-a-service with real-time database, serverless functions, and automatic caching. Use when working with Convex projects, writing queries/mutations/actions, defining schemas, using the Convex CLI, or integrating Convex with React/Next.js/Node.js applications.
4better-convex
ALWAYS use this skill when working with convex or better-convex. Covers the common end-to-end feature path using cRPC + ORM + auth + React, with setup/bootstrap and niche depth in references.
3manage-my-skills
Manage, update, and install personal agent skills from Derek-X-Wang/skills. Use when the user wants to create, edit, update, or install skills. Handles the full workflow — edit locally, commit, push, then npx skills install.
3cmux-team
Run a Claude Code agent team inside a cmux claude-teams session. Use when the current session was launched via `cmux claude-teams` and you want to spawn teammates that surface as separate cmux panels. Covers detection, the spawn → coordinate → shutdown contract, and a mode index — pick the matching `modes/<mode>.md` for the topology you actually want (feature build, AFK runner, parallel AFK runners, structured debate, parallel research).
3repo-knowledge-share
Cross-project knowledge sharing. Catalogs features and tech stacks across repos so you can reuse implementations. Use when building a feature that another project might already have, when the user asks "has any project done X?", or says "scan this project" / "update knowledge". Also triggers automatically on any invocation if the current project's knowledge is stale (>7 days since last scan).
3