Agent skills for working on Crystal code projects.
Reusable setup and workflow guidance for Crystal-first agent engineering.

Architecture · Development · Guidelines · Testing · PR Workflow

---

Like a forge, this project shapes rough ideas into dependable tools, but for Crystal engineering workflows. Each skill is a repeatable mold: it captures standards once, then applies them consistently across projects. The result is less setup friction and more predictable, high-quality Crystal work.

---

Quick Start

1. Install dependencies:

   make install

2. Run code quality gates:

   make format
   make lint
   make test

3. Run markdown checks:

   make markdown-check

Features

• Crystal-focused skill workflows under skills/.
• Crystal setup baseline including .ameba.yml and .rumdl.toml templates.
• Enforced Crystal code gates for format, lint, and specs.

Installation

1. Add the dependency to your shard.yml:

   dependencies:
     crystal_forge:
       github: dsisnero/crystal_forge

2. Run shards install

Usage

require "crystal_forge"

<!-- TODO: add concrete runtime usage examples as public APIs are added -->

Development

Essential commands:

make install
make format
make lint
make test
make markdown
make markdown-check

See Development Guide for full setup instructions.

Documentation

Document	Purpose
Architecture	System design and data flow
Development	Setup and daily workflow
Coding Guidelines	Code style and conventions
Testing	Test commands and patterns
PR Workflow	Commits, PRs, and review process

Contributing

1. Create an issue: /forge-create-issue
2. Implement: /forge-implement-issue <number>
3. Self-review: /forge-reflect-pr
4. Address feedback: /forge-address-pr-feedback
5. Update changelog: /forge-update-changelog

Contributors

• Dominic Sisneros - creator and maintainer