Software Development Skills

Verify Crystal Bubble Tea output against golden files using Crystal teatest/golden libraries.

Generate/update golden outputs from Go Bubble Tea tests using Charm teatest/golden libraries.

Orchestrate Bubble Tea Go-vs-Crystal parity work by routing to teatest/golden generation, Crystal verification, and fallback byte diagnostics. Use when parity work spans multiple steps or requires choosing the correct parity path and subskill handoffs.

Implement example-level Go-to-Crystal Bubble Tea parity by matching model/update/view behavior and deterministic harness inputs. Use when parity drift is owned by example logic rather than runtime/shard internals.

Track source-to-Crystal parity by generating inventories of source API and tests, validating drift, and seeding backlog work from missing coverage. Use for Go, Rust, Crystal, Java, Ruby, or TypeScript/JavaScript upstreams when you need reproducible parity manifests instead of ad-hoc tracking, especially when tree-sitter discovery or Prolog fact queries would make the inventory more reliable.

Set up or retrofit a repository with Crystal Forge meta-structure by creating CLAUDE.md/AGENTS.md, core docs, and baseline project conventions. Use when a project lacks agent-facing guidance or needs standardized engineering documentation and command gates.

Optimize Crystal code for performance by identifying hot code paths first, validating benchmark or profiling infrastructure, comparing against a clean baseline, and keeping only changes that improve verified metrics. Use this skill when users ask about Crystal performance optimization, slow Crystal code, memory usage, hot paths, benchmark-driven cleanup, or allocation-focused tuning in Crystal projects.

Use this skill in Crystal projects whenever code under ./lib (installed shards) is modified to preserve Go parity or fix shard behavior. Forks upstream repo to ./temp, implements TDD fix, pushes to fork, asks user to review before creating PR. Creates or updates upstream shard issues with reproducible failures, failing specs, environment details, and the local patch that fixes it.

Evaluate and select Crystal shard dependencies for a project by searching candidate libraries, comparing maintenance and fit, and applying the chosen dependency to shard.yml. Use when a port or feature needs a Crystal library replacement and dependency choice affects behavior, risk, or maintainability.

Initialize a Crystal project for language-porting work by creating baseline project structure, adding upstream as a git submodule, wiring quality gates, and documenting source-of-truth constraints. Use when starting a new Crystal port or retrofitting an existing Crystal repo for structured upstream parity work.

Execute behavior-faithful ports from Go, Rust, or similar languages into Crystal by translating APIs and tests while preserving upstream semantics and outputs. Use when implementing or continuing a source-based port where upstream behavior is the required contract.