amber-lang
GitHub提供Amber语言（编译为Bash）的全栈支持，涵盖代码编写、调试、解释及Bash转换。基于0.5.1-alpha版本，详解语法、类型系统、强制错误处理机制及标准库使用规范。
Trigger Scenarios
Install
npx skills add NeverSight/learn-skills.dev --skill amber-lang -g -y
SKILL.md
Frontmatter
{
"name": "amber-lang",
"source": "local",
"license": "MIT",
"description": "Write, debug, and explain Amber code — the modern language that compiles to Bash. Use this skill when the user asks to write shell scripts in Amber, convert Bash to Amber, debug Amber code, or asks about Amber syntax and features. Covers Amber 0.5.1-alpha syntax, types, error handling, standard library, and compilation."
}
This skill provides comprehensive knowledge of Amber (amber-lang.com), a modern programming language that compiles to Bash script. Use it to write, review, debug, convert, and explain Amber code.
Quick Reference
Amber compiles to Bash 3.2+ compatible scripts. It provides ECMAScript-inspired syntax, type safety, and mandatory error handling.
CLI: amber run <file.ab> | amber build <in.ab> <out.sh> | amber check <file.ab> | amber eval '<code>'
Shebang: #!/usr/bin/env amber | File extension: .ab
Types: Text, Int, Num (needs bc), Bool, Null, [T] (typed array, no nesting)
Key syntax patterns:
let x = 10 // variable
const Y = 20 // constant
fun add(a: Int, b: Int): Int { } // typed function
fun risky(): Int? { fail 1 } // failable function (? = can fail)
pub fun exported(): Null { } // public/exportable
fun modify(ref arr: [Int]) { } // pass by reference
$ command $ // shell execution
$ cmd $ failed(code) { } // error handling (MANDATORY)
$ cmd $? // propagate failure
import { fn } from "std/module" // stdlib import
import { fn } from "./file.ab" // local import
main (args) { } // entry point
Modifiers: silent (suppress output), trust (skip error handling), sudo (privilege escalation)
Control flow: if/else, if { cond: expr } (chain), ternary (x then a else b), loop, for i in 0..n, while
Code Style Guidelines
- Always handle errors — use
failed,succeeded,exited, or?for every failable operation - Use typed function signatures for clarity
- Prefer stdlib over raw commands (e.g.,
file_readover$ cat file $) - Use
mainblocks so scripts work correctly when imported - Use
constfor values that don't change - Avoid
trust— handle errors explicitly - Use ranges (
0..n) instead of manual counter loops
Additional References
For detailed syntax, types, operators, and all language features, see references/syntax.md
For standard library documentation:
- references/stdlib-text.md — Text manipulation (split, replace, regex, trim, parse, etc.)
- references/stdlib-array.md — Array operations (find, pop, shift, contains, etc.)
- references/stdlib-fs.md — File system (read, write, glob, chmod, extract, etc.)
- references/stdlib-env.md — Environment, I/O, styling (env vars, input prompts, colored output, etc.)
- references/stdlib-math-date-http.md — Math, date/time, and HTTP operations
For real-world example scripts, see references/examples.md
Version History
- e0220ca Current 2026-07-05 22:09
