@shd101wyy/yo 0.1.9 → 0.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -32,6 +32,8 @@ Yo aims to be **Simple** and **Fast** (around 0% - 15% slower than C).
32
32
  - [Contributing](#contributing)
33
33
  - [Setup](#setup)
34
34
  - [Editor Support](#editor-support)
35
+ - [AI Agent Skills](#ai-agent-skills)
36
+ - [Using in your own project](#using-in-your-own-project)
35
37
  - [Star History](#star-history)
36
38
  - [License](#license)
37
39
 
@@ -312,6 +314,28 @@ $ ./yo-cli compile src/tests/examples/fixme.yo
312
314
  - Vim / Neovim: a minimal syntax file and a usage README are available in `vscode-extension/syntaxes/`.
313
315
  See [vscode-extension/syntaxes/README.md](./vscode-extension/syntaxes/README.md) for installation steps, `ftdetect` examples and `home-manager` snippets.
314
316
 
317
+ ## AI Agent Skills
318
+
319
+ This repository ships a set of **agent skill files** that teach AI agents how to write Yo programs. The skills are portable — you can copy the `.github/skills/` directory into any Yo project and agents will be able to use them there too.
320
+
321
+ | Skill | Description |
322
+ | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
323
+ | [`yo-syntax`](.github/skills/yo-syntax/SKILL.md) | Core language syntax: curly braces, cond/match, structs, enums, operators, modules |
324
+ | [`yo-core-patterns`](.github/skills/yo-core-patterns/SKILL.md) | Everyday patterns: types, generics, traits, error handling, collections, iterators |
325
+ | [`yo-async-effects`](.github/skills/yo-async-effects/SKILL.md) | Async/await, algebraic effects, Exception, IO, spawning tasks |
326
+ | [`yo-project-workflow`](.github/skills/yo-project-workflow/SKILL.md) | `yo` CLI commands, `build.yo` project files, dependency management |
327
+
328
+ ### Using in your own project
329
+
330
+ Copy the skills directory into your Yo project:
331
+
332
+ ```bash
333
+ cp -r .github/skills /path/to/your-yo-project/.github/
334
+ # or .agents, .claude, etc depending on your agent platform
335
+ ```
336
+
337
+ Then in any AI agent session, invoke a skill by name (e.g. `@yo-syntax`) to give the agent contextual knowledge about the Yo language.
338
+
315
339
  ## Star History
316
340
 
317
341
  [![Star History Chart](https://api.star-history.com/svg?repos=shd101wyy/Yo&type=date&legend=top-left)](https://www.star-history.com/#shd101wyy/Yo&type=date&legend=top-left)