vhs

VHS terminal recording best practices from Charmbracelet (formerly charmbracelet-vhs). This skill should be used when writing, reviewing, or editing VHS tape files to create professional terminal GIFs and videos. Triggers on tasks involving .tape files, VHS configuration, terminal recording, demo creation, or CLI documentation.

Jump to install

Repository: pproenca/dot-skills
Last source activity: May 27, 2026 at 09:50
Detected SKILL.md language: English
Stars: 194
Forks: 17

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/pproenca/dot-skills --skill vhs

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

53 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

drizzle-nextjs-postgres

Drizzle ORM against PostgreSQL inside a Next.js App Router app. Covers client construction (globalThis singleton across HMR, serverless pool sizing, `prepare:false` behind PgBouncer/Supavisor, driver choice when you need interactive transactions, `server-only`), reads in Server Components under Next.js 16 Cache Components (`use cache` superseding `unstable_cache` and the `revalidate`/`dynamic` segment configs, Suspense boundaries, React `cache()` dedupe), Server Actions (authorization inside the action, `updateTag` vs `revalidateTag`, `after()`), Postgres schema types (timestamptz, identity vs serial, jsonb, numeric-as-string, bigint modes), drizzle-kit migrations (generate vs push, CONCURRENTLY outside the migrator, NOT VALID constraints, rename prompts), transactions and pooled connections, and Postgres query traps (keyset pagination, count cost, driver-dependent `db.execute()` shape, NOT IN nulls, prepared statements). Use when writing or reviewing Drizzle + Postgres code in Next.js.

2026-07-24

relational-data-modeling

Corrects the wrong defaults a model has when designing a relational schema — the DDL decisions an experienced engineer makes differently. Use when creating or reviewing tables, migrations, ER models, or ORM schema definitions. Covers identity and keys (surrogate vs natural, identity vs serial, uuidv7, composite keys that make cross-tenant references impossible), relationships (polymorphic foreign keys the database cannot enforce, referential actions, unindexed FK columns, disjoint subtypes), invariants the engine can prove instead of application code (EXCLUDE, partial unique indexes, CHECK limits, deferrable cycles, NOT VALID), types (timestamptz, exact money, range types, enum vs lookup table), derived and encoded data (generated columns, JSONB as an escape hatch), and time (events vs in-place updates, soft-delete flags that silently disable constraints, temporal keys). NOT for query tuning, index selection for read paths, or connection pooling.

2026-07-23

relational-database-design

Distills a logical relational-database design methodology into rules an agent applies while designing or reviewing a schema. Covers the design sequence (mission → tables → fields → keys → relationships → business rules → views → integrity review), one-subject-per-table decomposition, atomic single-valued fields, candidate/primary/foreign keys, relationship types with deletion rules and participation, the four levels of data integrity, database-vs-application business rules, validation tables, views for derived data, and the flat-file / spreadsheet / RDBMS-driven antipatterns to avoid. The structure is logical and RDBMS-agnostic, and normalized by construction. Use when designing a new relational schema, reviewing or refactoring an existing one, resolving redundant or repeating data, choosing keys, modeling relationships, or deciding where a constraint belongs.

2026-07-23

View all from this repository

name	vhs
description	VHS terminal recording best practices from Charmbracelet (formerly charmbracelet-vhs). This skill should be used when writing, reviewing, or editing VHS tape files to create professional terminal GIFs and videos. Triggers on tasks involving .tape files, VHS configuration, terminal recording, demo creation, or CLI documentation.

Charmbracelet VHS Best Practices

Comprehensive best practices guide for VHS terminal recordings, maintained by Charmbracelet. Contains 47 rules across 8 categories, prioritized by impact to guide creation of professional, portable, and optimized terminal demos.

When to Apply

Reference these guidelines when:

Writing new VHS tape files
Creating terminal demos for documentation
Setting up CI/CD for automated GIF generation
Optimizing recording file size and quality
Troubleshooting tape file issues
Reviewing tape files for best practices

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Configuration Structure	CRITICAL	`config-`
2	Dependency Management	CRITICAL	`deps-`
3	Command Syntax	HIGH	`cmd-`
4	Timing & Synchronization	HIGH	`timing-`
5	Output Optimization	MEDIUM-HIGH	`output-`
6	Visual Quality	MEDIUM	`visual-`
7	CI/Automation	MEDIUM	`ci-`
8	Advanced Patterns	LOW	`advanced-`

Quick Reference

1. Configuration Structure (CRITICAL)

config-settings-order - Place all settings before commands
config-output-first - Declare output at file start
config-shell-explicit - Explicitly set shell type
config-typing-speed-global - Set global TypingSpeed early
config-dimensions-explicit - Set explicit terminal dimensions
config-comments-document - Use comments to document tape structure

2. Dependency Management (CRITICAL)

deps-require-early - Use Require for dependency validation
deps-require-order - Place Require before settings
deps-require-all - Require all external commands
deps-system-requirements - Verify system dependencies

3. Command Syntax (HIGH)

cmd-type-syntax - Use correct Type command syntax
cmd-enter-explicit - Always follow Type with Enter
cmd-key-repeat - Use key repeat counts
cmd-ctrl-combinations - Use Ctrl combinations for terminal control
cmd-hide-show - Use Hide/Show for sensitive operations
cmd-env-variables - Use Env for environment variables
cmd-screenshot - Use Screenshot for static captures
cmd-multiline-type - Handle multiline commands properly

4. Timing & Synchronization (HIGH)

timing-sleep-after-enter - Add Sleep after commands for output
timing-wait-pattern - Use Wait for dynamic command completion
timing-type-speed-override - Override TypingSpeed for emphasis
timing-sleep-units - Use explicit time units
timing-final-sleep - End recordings with final Sleep
timing-natural-pauses - Add natural pauses between actions
timing-wait-timeout - Set appropriate Wait timeouts
timing-playback-speed - Use PlaybackSpeed for final adjustments

5. Output Optimization (MEDIUM-HIGH)

output-format-selection - Choose output format based on use case
output-framerate - Optimize framerate for file size
output-dimensions-optimize - Right-size terminal dimensions
output-loop-offset - Use LoopOffset for seamless loops
output-multiple-formats - Generate multiple output formats
output-relative-paths - Use relative paths for portability

6. Visual Quality (MEDIUM)

visual-font-readable - Choose readable font settings
visual-theme-selection - Select appropriate theme
visual-window-decoration - Add window decorations for polish
visual-spacing - Adjust letter and line spacing
visual-padding-margin - Use padding and margins effectively
visual-cursor-visibility - Ensure cursor visibility

7. CI/Automation (MEDIUM)

ci-github-action - Use official VHS GitHub Action
ci-auto-commit - Auto-commit generated assets
ci-golden-files - Use golden files for integration testing
ci-matrix-builds - Generate platform-specific demos
ci-caching - Cache VHS dependencies in CI

8. Advanced Patterns (LOW)

advanced-source-include - Use Source for reusable tape components
advanced-clipboard - Use Copy and Paste for complex input
advanced-recording-live - Record live sessions then edit
advanced-server-mode - Use server mode for remote access

How to Use

Read individual reference files for detailed explanations and code examples:

Section definitions - Category structure and impact levels
Rule template - Template for adding new rules

Reference Files

File	Description
AGENTS.md	Complete compiled guide with all rules
references/_sections.md	Category definitions and ordering
assets/templates/_template.md	Template for new rules
metadata.json	Version and reference information

vhs

Source facts

Install options

Review the source files

More from this repository

More from this repository

Charmbracelet VHS Best Practices

When to Apply

Rule Categories by Priority

Quick Reference

1. Configuration Structure (CRITICAL)

2. Dependency Management (CRITICAL)

3. Command Syntax (HIGH)

4. Timing & Synchronization (HIGH)

5. Output Optimization (MEDIUM-HIGH)

6. Visual Quality (MEDIUM)

7. CI/Automation (MEDIUM)

8. Advanced Patterns (LOW)

How to Use

Reference Files

Charmbracelet VHS Best Practices

When to Apply

Rule Categories by Priority

Quick Reference

1. Configuration Structure (CRITICAL)

2. Dependency Management (CRITICAL)

3. Command Syntax (HIGH)

4. Timing & Synchronization (HIGH)

5. Output Optimization (MEDIUM-HIGH)

6. Visual Quality (MEDIUM)

7. CI/Automation (MEDIUM)

8. Advanced Patterns (LOW)

How to Use

Reference Files