Official SKILL.md for Aether language?

[TG0]

The idea came from discussion #123

Since using AI for coding is a huge thing nowadays, Aether should support AI assisted coding as much as possible. Defining a skill for Aether, especially when the language is not well known yet, would help in this.

While you can always git clone the whole Aether repo and open it for AI agent so it can browse through documentation and examples, using a SKILL.md file would likely be more efficient (faster and keeps context window smaller) and does not rule out using the whole repo as context as a secondary option, if the agent does not get what it needs from the SKILL:md.

Here's a suggestion, with just few example titles, how the file could look like:

# SKILL: Aether-programming-language

## Loops


## Functions


## Error handling


## Data structures


## Map + Filter

### DO NOT DO THIS

res = data.filter(...).map(...)
res := Map(Filter(data, isEven), square)

### DO THIS INSTEAD

evens = list.filter(data) |v| { return v % 2 == 0 }
res   = list.map(evens) |v| { return v * v }

### RULES

- No method chaining
- Do not compose into one expression
- Use intermediate variables

### EXAMPLE

data  = [1, 2, 3, 4, 5, 6]

evens = list.filter(data) |v| { return v % 2 == 0 }
res   = list.map(evens) |v| { return v * v }

// result: [4, 16, 36]

[nicolas-maman]

This is a good idea, we need to add a SKILL.md at the repo root. Dense, declarative, under 200 lines, syntax rules, valid patterns, anti-patterns, and build commands.

[TG0]

Maybe create an own skill file for building, as AI agents can load the skills dynamically based on it’s description and will do this only if there is a need. Better for context window, better for accuracy. Some libaries might deserve own skills too. What do you think? 🤔