Document the skill more fully

shikokuchuo · shikokuchuo · commit f74691ea48fc · 2026-04-09T11:58:49.000+01:00
diff --git a/.claude/skills/mirai b/.claude/skills/mirai
@@ -0,0 +1 @@
+../../dev/skills/mirai
diff --git a/.gitignore b/.gitignore
@@ -4,7 +4,8 @@
 .Ruserdata
 /docs/
 /revdep/
-/.claude/
+/.claude/*
+!/.claude/skills/
 /.quarto/
 **/*.quarto_ipynb
 .DS_Store
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -2,6 +2,10 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## Skill
+
+The mirai skill at `.claude/skills/mirai/SKILL.md` (symlinked from `dev/skills/mirai/`) provides LLM-optimized guidance for writing correct mirai code. It is also distributed via the `r-lib` skill in the [`posit-dev-skills`](https://github.com/posit-dev/posit-dev-skills) plugin for end users.
+
 ## Overview
 
 mirai is a minimalist async evaluation framework for R that provides asynchronous, parallel and distributed computing. Built on nanonext and NNG (Nanomsg-Next-Generation), it implements a message-passing paradigm where daemons (persistent background processes) execute tasks sent by the host process. Only runtime dependency: nanonext. Requires R >= 3.6.
diff --git a/README.Rmd b/README.Rmd
@@ -159,10 +159,12 @@ mirai has become the convergence point for asynchronous and parallel computing a
 
 ### Links
 
-[mirai](https://mirai.r-lib.org/) | 
-[nanonext](https://nanonext.r-lib.org/) | 
+[mirai](https://mirai.r-lib.org/) |
+[nanonext](https://nanonext.r-lib.org/) |
 [CRAN HPC Task View](https://cran.r-project.org/view=HighPerformanceComputing)
 
+AI coding agents: the `r-lib` agent skill from the [`posit-dev-skills`](https://github.com/posit-dev/posit-dev-skills) plugin provides mirai-specific guidance.
+
 --
 
 Please note that this project is released with a [Contributor Code of Conduct](https://mirai.r-lib.org/CODE_OF_CONDUCT.html). By participating in this project you agree to abide by its terms.
diff --git a/README.md b/README.md
@@ -190,6 +190,10 @@ discussions.
 [nanonext](https://nanonext.r-lib.org/) \| [CRAN HPC Task
 View](https://cran.r-project.org/view=HighPerformanceComputing)
 
+AI coding agents: the `r-lib` agent skill from the
+[`posit-dev-skills`](https://github.com/posit-dev/posit-dev-skills)
+plugin provides mirai-specific guidance.
+
 –
 
 Please note that this project is released with a [Contributor Code of
diff --git a/dev/vignettes/_v06-packages.Rmd b/dev/vignettes/_v06-packages.Rmd
@@ -15,6 +15,10 @@ knitr::opts_chunk$set(
 )
 ```
 
+### Agent Skill
+
+AI coding agents: the `r-lib` agent skill from the [`posit-dev-skills`](https://github.com/posit-dev/posit-dev-skills) plugin provides mirai-specific guidance for writing correct async, parallel, and distributed code.
+
 ### 1. Developer Interfaces
 
 mirai provides these functions for package authors:
diff --git a/vignettes/v06-packages.Rmd b/vignettes/v06-packages.Rmd
@@ -8,6 +8,10 @@ vignette: >
 
 
 
+### Agent Skill
+
+AI coding agents: the `r-lib` agent skill from the [`posit-dev-skills`](https://github.com/posit-dev/posit-dev-skills) plugin provides mirai-specific guidance for writing correct async, parallel, and distributed code.
+
 ### 1. Developer Interfaces
 
 mirai provides these functions for package authors:

Original file line number	Diff line number	Diff line change
`@@ -15,6 +15,10 @@ knitr::opts_chunk$set(`
`15`	`15`	`)`
`16`	`16`	```
`17`	`17`
	`18`	`+### Agent Skill`
	`19`	`+`
	`20`	+AI coding agents: the `r-lib` agent skill from the [`posit-dev-skills`](https://github.com/posit-dev/posit-dev-skills) plugin provides mirai-specific guidance for writing correct async, parallel, and distributed code.
	`21`	`+`
`18`	`22`	`### 1. Developer Interfaces`
`19`	`23`
`20`	`24`	`mirai provides these functions for package authors:`