roc-language

rickhull/roc-init

9 stars

1 forks

Just

80 views

View on GitHub Add to Favorites

SKILL.md

name: roc-language description: | Authoritative Roc programming language reference. When Claude needs to read, write, edit, debug, or analyze any .roc file, or understand Roc syntax, types, or compiler errors. Provides current API reference and syntax patterns using Roc compiler source as ground truth. version: 1.0.0

Roc Language

Critical Notes

WARNING: Outdated Documentation Exists

Many online tutorials reference the old Rust-based Roc compiler
Current Roc uses different builtin functions than old docs show
Example: Num.to_str does NOT exist in current Roc; use Str.inspect instead

Eager Load

Always read in full:

Mini Tutorial: @references/mini-tutorial-new-compiler.md (~700 lines, 28KB)
Gotchas: @references/GOTCHAS.md (~200 lines, 8KB)

Lazy Load

Search or read as necessary:

Mini Tutorial Augments: references/MINI_TUTORIAL_AUGMENTS.md (~1100 lines, 28KB)
Builtin Reference: references/Builtin.roc (~1500 lines, 48KB)
Syntax Reference: references/all_syntax_test.roc (~400 lines, 12KB)
Language Reference Tutorial: references/ROC_LANGREF_TUTORIAL.md (~2200 lines, 44KB)

Installation

Option 1: Use slash command in Claude Code

/install-skill https://github.com/rickhull/roc-init

Option 2: Clone to skills directory

# Global (all projects)

git clone https://github.com/rickhull/roc-init ~/.claude/skills/roc-init

# Project-specific

git clone https://github.com/rickhull/roc-init .claude/skills/roc-init

Add MCP server to .cursor/mcp.json:

{
  "mcpServers": {
    "skillz": {
      "command": "npx",
      "args": ["-y", "skillz-mcp", "https://github.com/rickhull/roc-init"]
    }
  }
}

Restart Cursor after adding the configuration.

Option 1: Use Gemini CLI command

gemini extensions install https://github.com/rickhull/roc-init

Option 2: Clone to extensions directory

git clone https://github.com/rickhull/roc-init ~/.gemini/extensions/roc-init

Topics

documentation roc skill

Related Skills

skill-name

Description of what the skill does and when to use it

Use when creating well-structured, conventional git commits from code changes. Triggers after completing work, before pushing changes, or when organizing unstaged/staged changes into meaningful commits. Triggers on "commit", "git commit", "create commit", "stage changes", "conventional commits", "commit message", "atomic commits".