agentsclimarketplace

Crystal forge setup project

Skill dsisnero/crystal_forge/skills/crystal-forge-setup-project

A set of skills to help with Crystal development

Install
npx -y skills add dsisnero/crystal_forge --skill crystal-forge-setup-project

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Set up or retrofit a repo with Crystal Forge project scaffolding. Use when a repository lacks `CLAUDE.md`, `AGENTS.md`, baseline docs, or consistent local quality gates.

SKILL.md

2.2 KB, 535 tokens by cl100k_base, as published. Nobody here has run it

Crystal Forge Project Setup

This skill owns repo-level scaffolding only. Use initialize-crystal-porting-project for upstream submodule bootstrap and porting-to-crystal for implementation work.

Workflow

1. Inspect before editing

Check which of these already exist and reuse real project commands instead of inventing generic ones:

  • CLAUDE.md
  • AGENTS.md
  • README.md
  • CHANGELOG.md
  • .gitignore
  • docs/
  • Makefile or equivalent scripts

2. Create or tighten CLAUDE.md

Include only:

  1. Project name and one-line purpose
  2. Verified commands such as install, update, format, lint, test
  3. Links to the core docs
  4. A short principles section
  5. Concrete project conventions when they are real and repo-specific

For Crystal projects, prefer:

crystal tool format --check src spec
ameba src spec
crystal spec

3. Sync AGENTS.md

Point AGENTS.md at CLAUDE.md with a symlink when possible:

ln -sf CLAUDE.md AGENTS.md

4. Ensure core docs exist

Create concise starter docs only for missing files:

  • docs/architecture.md
  • docs/development.md
  • docs/coding-guidelines.md
  • docs/testing.md
  • docs/pr-workflow.md

5. Normalize repo-local temp and ignore rules

  • Keep generated scratch data under ./temp.
  • Ensure .gitignore ignores temp/ and .crystal-cache/.
  • Do not ignore docs/.
  • Use templates.gitignore as the baseline if a file is missing.

6. Ensure cleanup and lint config

  • Makefile should expose clean and remove ./temp/*.
  • Crystal repos should also have:
    • .ameba.yml from templates.ameba.yml
    • .rumdl.toml from templates.rumdl.toml
  • Exclude temp/ from lint/format/documentation tooling where needed.

Verification

Confirm all of the following:

  1. Commands listed in CLAUDE.md exist.
  2. AGENTS.md resolves to CLAUDE.md.
  3. Doc links resolve.
  4. Repo policy text is not duplicated across multiple files.
  5. temp/ is ignored and the cleanup path is explicit.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.