arch-tsdown-cli

Name: arch-tsdown-cli
Author: hairyf

github.com/hairyfDevelopment26175 installsUpdated 2w ago

About arch-tsdown-cli

A starter skill for creating TypeScript CLI packages with tsdown, aimed at developers who need a minimal setup for both a library and executable. It documents an ESM-only build, declaration generation, testing, linting, and release practices.

Key features

01Library and executable package layout
02ESM build with declaration generation
03tsx development executable
04pnpm, Vitest, and ESLint setup
05CI and release references

Use cases

01Starting a TypeScript CLI package
02Configuring development and production binaries
03Preparing package exports and release workflows

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hairyf/skills --skill arch-tsdown-cli

After installing, type/arch-tsdown-cliin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

GENERATION.md

assets/

ci.yml

release.yml

references/

best-practices-cli.md

core-bin-entry.md

core-ci.md

core-git-hooks.md

core-overview.md

core-package-exports.md

core-scripts.md

core-testing.md

core-tooling.md

core-tsdown-config.md

Details

From the project README

arch-tsdown-cli is a TypeScript CLI package starter (based on hairyf/starter-cli) that uses tsdown for building. It provides a minimal, opinionated setup: dual surface (library + bin), ESM-only output, automatic .d.ts generation, dev bin via tsx, pnpm, Vitest, ESLint, and optional npm Trusted Publisher for CI-based releases.

The skill is based on starter-cli (arch-tsdown-cli source), generated at 2026-01-30.

Recommended practices:

Use dev bin (tsx) locally and prod bin (dist) in publishConfig
Build pure ESM; enable dts and keep external for dependencies
Use npm Trusted Publisher for releases

Core References

Topic	Description	Reference
Overview	Project purpose, structure, when to use	core-overview
Bin Entry	dev vs prod bin, shebang, tsx	core-bin-entry
tsdown Config	entry, format, dts, external	core-tsdown-config
Scripts & Release	build, dev, start, release, npm Trusted Publisher	core-scripts
Package Exports	dist, bin, publishConfig, files	core-package-exports
Tooling	ESLint, TypeScript, Vitest config	core-tooling
Git Hooks	simple-git-hooks, lint-staged, pre-commit	core-git-hooks
CI	GitHub Actions — lint, typecheck, test matrix	core-ci
Testing	Vitest, vitest-package-exports	core-testing

Best Practices

Topic	Description	Reference
CLI & Package	bin, ESM, dts, external, release	best-practices-cli

Comments

Markdown supported

Details

Author: hairyf
Repository: hairyf/skills
Category: Development
Installs: 175
GitHub stars: 26

Report

More skills

All skills

remotion-render

github.com/inference-sh

1.6M

Render videos from React/Remotion component code via inference.sh. Pass TSX code, get MP4. Supports all Remotion APIs: useCurrentFrame, useVideoConfig, spring, interpolate, AbsoluteFill, Sequence. Configurable resolution, FPS, duration, codec. Use for: programmatic video generation, animated graphics, motion design, data-driven videos, React animations to video. Triggers: remotion, render video from code, tsx to video, react video, programmatic video, remotion render, code to video, animated video, motion graphics code, react animation video

improve-codebase-architecture

github.com/mattpocock

1.2M

Scan a codebase for architecture improvement opportunities, present them as a visual HTML report, then dive deep into whichever one you pick.

design-mobile-apps

github.com/designed-by-ai

1.1M

Design mobile app screens with Sleek, edit Sleek projects, and implement their designs in React Native or HTML

vercel-react-best-practices

github.com/vercel-labs

848.6k

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.