robacarp/dotfiles / .claude/skills/crystal
crystal
VerifiedUse when working on Crystal projects. Detected by the presence of a shard.yml file.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.2 KB |
SKILL.md
View on GitHub---
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |