Skip to content

robacarp/dotfiles / .claude/skills/crystal

crystal

Verified

Use when working on Crystal projects. Detected by the presence of a shard.yml file.

FileKindSize
SKILL.mdskill md1.2 KB
---
name: crystal
description: Use when working on Crystal projects. Detected by the presence of a shard.yml file.
disable-model-invocation: false
user-invocable: false
allowed-tools: Bash
---

# Crystal Project Workflow

## Shard management

- Never manually edit `shard.lock` — run `shards install` to regenerate it after changing `shard.yml`.
- When pointing a shard at a GitHub repo without a published version tag, add `branch: master` to `shard.yml` so the resolver can find it.
- Local `path:` dependencies are for development only — always switch to `github:` before committing.

## Building and running

- `shards run --error-trace <target>` — compile and run a target listed in `shard.yml` in one step.
- `crystal tool format` — format all Crystal files in the project.
- `crystal spec spec/path/to/test_spec.cr:LINE_NUMBER --error-trace` — run a specific test with error traces.

## Testing patterns

- Tests use Minitest, not Crystal's built-in `spec` framework.
- To test private methods, add a public proxy method on the class that delegates to the private one (see existing specs for examples).
- Test files live in `spec/` mirroring the `src/` directory structure.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall