From 837a7ea7610f3831f482ea8e40ea2fa4397f5ce4 Mon Sep 17 00:00:00 2001 From: shinyobjectz Date: Thu, 12 Nov 2026 18:02:15 -0800 Subject: [PATCH] skills/ is raea's plugin for Claude: the raea skill and raea's two hooks, ready for Claude's plugin directory skills/.claude-plugin/plugin.json names the plugin `raea` (skills: ./raea, the directory listing's icon and links), skills/hooks/hooks.json runs hooks/raea-hook.sh before a Bash command and after Write, Edit or MultiEdit, and that script hands the tool call to `raea hook claude`: media opened in the Mac's viewer goes to `raea show` once, and a saved composition gets raea's quick check. The script does nothing without raea on PATH, or when `raea skills install` already put the hooks in ~/.claude/settings.json, so they never run twice. skills/README.md says what the plugin runs and sends, as the directory asks. .claude-plugin/marketplace.json at the root makes this repository a marketplace: /plugin install raea --marketplace shinyobjectz/raea-skills. skillcheck reads the manifest (features/plugin.feature): it must parse and name the plugin, its skills must list every skill folder and nothing that isn't one, and hooks/ isn't checked as a skill. just link skips folders with no SKILL.md; just plugin runs claude plugin validate on the plugin and the marketplace (both pass; the one warning is the version, left out so each commit is the plugin's version). Tested: just ci (17 scenarios), the hook script with and without raea and with raea's hooks already in settings, the after-save check on a composition, and a Claude Code session with --plugin-dir skills, which lists raea:raea and runs the plugin's PreToolUse hook. raea's release.sh stages only skill folders from now on (shinyobjectz/raea#123), so the plugin's files stay out of ~/.claude/skills. --- .claude-plugin/marketplace.json | 17 +++++++ CLAUDE.md | 3 ++ README.md | 10 +++- crates/skillcheck/src/lib.rs | 80 +++++++++++++++++++++++++++++- crates/skillcheck/tests/bdd.rs | 17 +++++++ docs/HOW-SKILLS-WORK.md | 4 ++ features/plugin.feature | 74 +++++++++++++++++++++++++++ justfile | 12 +++++ skills/.claude-plugin/plugin.json | 19 +++++++ skills/README.md | 69 ++++++++++++++++++++++++++ skills/hooks/hooks.json | 28 +++++++++++ skills/hooks/raea-hook.sh | 10 ++++ skills/icon.png | Bin 0 -> 13203 bytes 13 files changed, 340 insertions(+), 3 deletions(-) create mode 100644 .claude-plugin/marketplace.json create mode 100644 features/plugin.feature create mode 100644 skills/.claude-plugin/plugin.json create mode 100644 skills/README.md create mode 100644 skills/hooks/hooks.json create mode 100755 skills/hooks/raea-hook.sh create mode 100644 skills/icon.png diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 0000000..c21c0c3 --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,17 @@ +{ + "name": "raea", + "owner": { + "name": "raea", + "url": "https://raea.io" + }, + "metadata": { + "description": "raea's plugin for Claude: the raea skill and its hooks, from the skills/ folder of this repository." + }, + "plugins": [ + { + "name": "raea", + "source": "./skills", + "description": "Make video, motion graphics, games and 3D scenes with raea, the Render Anything Engine: the raea skill, and hooks that run raea's quick check on a composition after it's saved and show media in the raea app instead of the Mac's viewer." + } + ] +} diff --git a/CLAUDE.md b/CLAUDE.md index 1f6245c..0677ae3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -29,6 +29,9 @@ programmer. Teach as you go, in plain words. ## Layout - `skills//SKILL.md` — the skills (`_template/` is skipped by checks) +- `skills/` is also raea's Claude plugin: `.claude-plugin/plugin.json` (its `skills` must list every skill), + `hooks/` (not a skill), `README.md` (what the plugin runs, shown in Claude's plugin directory) and `icon.png`. + `just plugin` runs Claude Code's validator on it. - `features/*.feature` — behaviour specs (Gherkin), run by `crates/skillcheck/tests/bdd.rs` - `crates/skillcheck/` — the Rust checker - `upstream/raea/` — generated by `just sync-raea`; never hand-edit diff --git a/README.md b/README.md index d85e69a..8aa805a 100644 --- a/README.md +++ b/README.md @@ -35,11 +35,19 @@ just ci # run every check | `just link` | install this repo's skills into Claude Code, live | | `just drift` | after a raea update: re-snapshot, list stale skills | | `just word cut` | check a term with montology before using it | +| `just plugin` | check the Claude plugin (`skills/`) with Claude Code's own validator | + +## Use it as a Claude plugin + +`skills/` is raea's plugin for Claude: the skills its manifest lists, plus hooks that run raea's quick check +after a composition is saved and send media to `raea show`. Install it in Claude Code with +`/plugin install raea --marketplace shinyobjectz/raea-skills`; [skills/README.md](skills/README.md) says what it runs. +A new skill goes in `skills/.claude-plugin/plugin.json`'s `skills` too, or `just check` fails. ## Layout ``` -skills/ one folder per skill (SKILL.md) +skills/ one folder per skill (SKILL.md); the folder is also raea's Claude plugin features/ behaviour specs in Gherkin (Given / When / Then) crates/ skillcheck — the Rust checker and test runner upstream/raea/ snapshot of the raea these skills are checked against diff --git a/crates/skillcheck/src/lib.rs b/crates/skillcheck/src/lib.rs index b06dc96..facd946 100644 --- a/crates/skillcheck/src/lib.rs +++ b/crates/skillcheck/src/lib.rs @@ -311,13 +311,15 @@ pub fn check_skill(dir: &Path, upstream: Option<&Upstream>) -> Vec { out } -/// Checks every skill under `skills_dir` (folders starting with `_` or `.` are skipped). +/// Checks every skill under `skills_dir` (folders starting with `_` or `.` are skipped, and so are the plugin's own +/// folders when `skills_dir` is a Claude plugin), then the plugin's manifest. pub fn check_repo(skills_dir: &Path, upstream_dir: &Path) -> Result { let upstream = Upstream::load(upstream_dir)?; let mut report = Report::default(); if !skills_dir.exists() { return Ok(report); } + let plugin = skills_dir.join(PLUGIN_MANIFEST).is_file(); let mut dirs: Vec<_> = fs::read_dir(skills_dir) .with_context(|| format!("reading {}", skills_dir.display()))? .filter_map(|e| e.ok()) @@ -325,17 +327,91 @@ pub fn check_repo(skills_dir: &Path, upstream_dir: &Path) -> Result { .filter(|p| p.is_dir()) .filter(|p| { let n = p.file_name().unwrap_or_default().to_string_lossy(); - !n.starts_with('_') && !n.starts_with('.') + !n.starts_with('_') + && !n.starts_with('.') + && !(plugin && PLUGIN_DIRS.contains(&n.as_ref())) }) .collect(); dirs.sort(); + let mut names = Vec::new(); for dir in dirs { report.skills_checked += 1; report.findings.extend(check_skill(&dir, upstream.as_ref())); + names.push( + dir.file_name() + .unwrap_or_default() + .to_string_lossy() + .to_string(), + ); + } + if plugin { + report.findings.extend(check_plugin(skills_dir, &names)); } Ok(report) } +/// The manifest that makes the skills folder a Claude plugin, relative to it. +pub const PLUGIN_MANIFEST: &str = ".claude-plugin/plugin.json"; +/// The plugin's own folders beside the skills, which aren't skills. +pub const PLUGIN_DIRS: &[&str] = &["hooks"]; + +/// Checks the plugin manifest: it parses, has a name, and its `skills` lists every skill folder and nothing else, so +/// no skill is left out of the plugin and no entry points at a skill that's gone. +pub fn check_plugin(skills_dir: &Path, skills: &[String]) -> Vec { + let mut out = Vec::new(); + let mut fail = |message: String| { + out.push(Finding { + level: Level::Error, + skill: "plugin".into(), + message, + }) + }; + let path = skills_dir.join(PLUGIN_MANIFEST); + let manifest: serde_yaml::Value = match fs::read_to_string(&path) + .map_err(|e| e.to_string()) + .and_then(|t| serde_yaml::from_str(&t).map_err(|e| e.to_string())) + { + Ok(v) => v, + Err(e) => { + fail(format!("{PLUGIN_MANIFEST} doesn't parse: {e}")); + return out; + } + }; + if manifest + .get("name") + .and_then(|n| n.as_str()) + .is_none_or(str::is_empty) + { + fail(format!("{PLUGIN_MANIFEST} has no `name`")); + } + let listed: Vec<&str> = match manifest.get("skills") { + Some(serde_yaml::Value::String(s)) => vec![s.as_str()], + Some(serde_yaml::Value::Sequence(v)) => v.iter().filter_map(|s| s.as_str()).collect(), + _ => Vec::new(), + }; + let folder = |entry: &str| { + entry + .trim_start_matches("./") + .trim_end_matches('/') + .to_string() + }; + for name in skills { + if !listed.iter().any(|e| folder(e) == *name) { + fail(format!( + "skills/{name} isn't in the plugin's skills ({PLUGIN_MANIFEST}): add \"./{name}\", or the plugin ships without it" + )); + } + } + for entry in listed { + if !skills_dir.join(folder(entry)).join("SKILL.md").is_file() { + fail(format!( + "the plugin's skills list {entry:?}, which holds no SKILL.md" + )); + } + } + out +} + #[cfg(test)] mod tests { use super::*; diff --git a/crates/skillcheck/tests/bdd.rs b/crates/skillcheck/tests/bdd.rs index dfb0dfc..5461f50 100644 --- a/crates/skillcheck/tests/bdd.rs +++ b/crates/skillcheck/tests/bdd.rs @@ -58,6 +58,23 @@ fn empty_folder(lib: &mut Library, name: String) { fs::create_dir_all(lib.root().join("skills").join(name)).unwrap(); } +#[given(expr = "the plugin manifest lists the skills {string}")] +fn plugin_lists(lib: &mut Library, entries: String) { + let list: Vec = entries + .split_whitespace() + .map(|e| format!("{e:?}")) + .collect(); + let manifest = format!("{{\"name\": \"raea\", \"skills\": [{}]}}", list.join(", ")); + plugin_manifest(lib, manifest); +} + +#[given(expr = "the plugin manifest is {string}")] +fn plugin_manifest(lib: &mut Library, text: String) { + let dir = lib.root().join("skills/.claude-plugin"); + fs::create_dir_all(&dir).unwrap(); + fs::write(dir.join("plugin.json"), text).unwrap(); +} + #[when("I run the skill check")] fn run_check(lib: &mut Library) { let root = lib.root(); diff --git a/docs/HOW-SKILLS-WORK.md b/docs/HOW-SKILLS-WORK.md index bccb490..2187059 100644 --- a/docs/HOW-SKILLS-WORK.md +++ b/docs/HOW-SKILLS-WORK.md @@ -39,6 +39,10 @@ This is called *progressive disclosure*: small label, bigger body, deepest detai | `/.claude/skills/` | Anyone working in that project | | A plugin (like i-have-adhd) | Whoever installs the plugin | +This repo's `skills/` folder is itself a plugin, `raea`, listed in Claude's plugin +directory: whoever installs it gets the skills its manifest +(`skills/.claude-plugin/plugin.json`) lists, plus raea's hooks. + `just link` puts this repo's skills into `~/.claude/skills/` as links, so your edits apply the next session — no copying. diff --git a/features/plugin.feature b/features/plugin.feature new file mode 100644 index 0000000..38df8e2 --- /dev/null +++ b/features/plugin.feature @@ -0,0 +1,74 @@ +Feature: The skills folder is a Claude plugin + skills/ is also raea's plugin for Claude: skills/.claude-plugin/plugin.json names it, and Claude Code, Cowork and + claude.ai load the skills its `skills` lists. A skill the manifest leaves out never reaches the plugin's users, so + every skill folder must be listed, and every entry must be a skill. The plugin's own folders (hooks/) aren't skills. + + Background: + Given raea "0.1.0-canary.3" is the current upstream snapshot + + Scenario: Every skill listed passes + Given a skill folder "cut-by-words" with this SKILL.md: + """ + --- + name: cut-by-words + description: Cut talking-head footage at the words a person chooses, with raea cut. + metadata: + raea-tested-against: 0.1.0-canary.3 + --- + # Cut by words + """ + And the plugin manifest lists the skills "./cut-by-words" + When I run the skill check + Then it passes with no warnings + + Scenario: A skill the manifest leaves out fails + Given a skill folder "cut-by-words" with this SKILL.md: + """ + --- + name: cut-by-words + description: Cut talking-head footage at the words a person chooses, with raea cut. + metadata: + raea-tested-against: 0.1.0-canary.3 + --- + """ + And a skill folder "captions" with this SKILL.md: + """ + --- + name: captions + description: Put captions on a cut from its words, with raea. + metadata: + raea-tested-against: 0.1.0-canary.3 + --- + """ + And the plugin manifest lists the skills "./cut-by-words" + When I run the skill check + Then it fails + And an error mentions "skills/captions isn't in the plugin's skills" + + Scenario: A manifest entry with no skill fails + Given a skill folder "cut-by-words" with this SKILL.md: + """ + --- + name: cut-by-words + description: Cut talking-head footage at the words a person chooses, with raea cut. + metadata: + raea-tested-against: 0.1.0-canary.3 + --- + """ + And the plugin manifest lists the skills "./cut-by-words ./gone" + When I run the skill check + Then it fails + And an error mentions "holds no SKILL.md" + + Scenario: The plugin's hooks folder is not a skill + Given an empty skill folder "hooks" + And the plugin manifest lists the skills "" + When I run the skill check + Then it passes + And 0 skills were checked + + Scenario: A manifest that doesn't parse fails + Given the plugin manifest is "{ not json" + When I run the skill check + Then it fails + And an error mentions "doesn't parse" diff --git a/justfile b/justfile index b70a4eb..45efa00 100644 --- a/justfile +++ b/justfile @@ -68,6 +68,7 @@ link: mkdir -p ~/.claude/skills for d in skills/*/; do n="$(basename "$d")"; [[ "$n" == _* ]] && continue + [ -f "skills/$n/SKILL.md" ] || continue # the plugin's hooks/ isn't a skill ln -sfn "$PWD/skills/$n" ~/.claude/skills/"$n" echo "linked $n" done @@ -80,6 +81,17 @@ unlink: [ -L ~/.claude/skills/"$n" ] && rm ~/.claude/skills/"$n" && echo "unlinked $n" done; true +# ── The Claude plugin ────────────────────────────────── + +# Check the plugin (skills/) and its marketplace with Claude Code's own validator +plugin: + claude plugin validate skills + claude plugin validate . + +# Try the plugin in one Claude Code session, without installing it +plugin-try: + claude --plugin-dir skills + # ── Tracking raea ────────────────────────────────────── # Snapshot the installed raea into upstream/raea/ (run after every raea update) diff --git a/skills/.claude-plugin/plugin.json b/skills/.claude-plugin/plugin.json new file mode 100644 index 0000000..4d307c7 --- /dev/null +++ b/skills/.claude-plugin/plugin.json @@ -0,0 +1,19 @@ +{ + "name": "raea", + "displayName": "raea", + "description": "Make video, motion graphics, games and 3D scenes with raea, the Render Anything Engine: the raea skill, and hooks that run raea's quick check on a composition after it's saved and show media in the raea app instead of the Mac's viewer.", + "author": { + "name": "raea", + "url": "https://raea.io" + }, + "homepage": "https://raea.io", + "repository": "https://github.com/shinyobjectz/raea-skills", + "license": "Apache-2.0", + "keywords": ["video", "motion-graphics", "3d", "games", "rendering", "bevy", "react", "typescript"], + "icon": "./icon.png", + "documentationUrl": "https://raea.io/docs/", + "supportUrl": "https://github.com/shinyobjectz/raea-skills/issues", + "privacyPolicyUrl": "https://raea.io/privacy/", + "termsOfServiceUrl": "https://raea.io/terms/", + "skills": ["./raea"] +} diff --git a/skills/README.md b/skills/README.md new file mode 100644 index 0000000..b62bbf6 --- /dev/null +++ b/skills/README.md @@ -0,0 +1,69 @@ +# raea for Claude + +raea is the Render Anything Engine. You write a video, a motion graphic, a game or a 3D scene as React and TypeScript, +and raea renders it on your computer's GPU with an engine built on Bevy. The same file renders to video, plays live as +a game, or renders single frames to check. This plugin teaches Claude to use raea well and connects Claude Code to it. + +## What's in it + +- **The raea skill** (`raea/`). It covers how to install raea, write a composition, render and check it, and what each + kind of work needs: footage cut by its words, motion graphics and type, sound and music, 3D scenes (Bevy materials, + lights, physics, Gaussian splats), games, app interfaces, generated media, and delivery. Its `reference/` files are + generated from raea's code, so they list the real verbs, flags and SDK imports. +- **Two hooks** (`hooks/`), for Claude Code and Cowork. Before Claude runs a shell command, a command that opens a + still, a video or a sound in the Mac's viewer is stopped once and Claude is told to use `raea show`, which puts it in + the raea app where you can answer it; the same command again goes through. This happens only while the raea app is + installed. After Claude saves a composition (a `.tsx` file that calls `registerRoot`), `raea check --quick` runs on + it and Claude gets what it finds. + +## Install the plugin + +Add it from the plugin directory: **Customize > Plugins** on claude.ai, or `/plugin directory` in Claude Code. Or install +it straight from this repository in Claude Code (2.1.275 or later): + +``` +/plugin install raea --marketplace shinyobjectz/raea-skills +``` + +## Install raea + +The plugin uses the `raea` command, which you install yourself: + +- macOS (Apple Silicon) or Linux (x86_64): `curl -fsSL https://raea.io/install | sh` +- Windows 10 or 11, in PowerShell: `irm https://raea.io/install.ps1 | iex` + +Until `raea` is on your PATH the hooks do nothing, and the skill tells Claude how to install it when you ask for +something that needs it. raea's installer also copies the skill into `~/.claude/skills`; with the plugin you can set +`RAEA_NO_SKILLS=1` when you install raea to skip that copy. + +If you already ran `raea skills install --agent claude`, the same two hooks are in `~/.claude/settings.json`, and the +plugin's hook script steps aside so they never run twice. + +## Where it works + +| | Skill | Hooks | +|---|---|---| +| Claude Code | yes | yes | +| Cowork | yes | yes, when raea is installed where the session runs | +| Chat on claude.ai | yes | no (chat doesn't run hooks) | + +Rendering needs raea on a computer, so in chat the skill can explain and write compositions but can't render them. + +## What it runs and sends + +The plugin itself sends nothing anywhere and stores nothing. Its hook script (`hooks/raea-hook.sh`) runs +`raea hook claude` on your computer, which reads the tool call Claude Code hands it, may run raea's quick check on the +saved file, and keeps a small marker under `~/.raea/hooks` so a command it stopped goes through when tried again. It +reads `~/.claude/settings.json` only to see whether raea's hooks are already there. + +The skill tells Claude to run the `raea` command, which works on your computer. A few of raea's verbs reach the +network when you ask for them: the installer downloads raea from raea.io, `raea gen` calls the generation providers you +set up with your own keys (and spends your money there, so the skill has Claude quote the cost first), and a review +link made in the raea app uploads the cut you choose to share. raea's privacy policy is at https://raea.io/privacy/. + +## Source and license + +This folder is the `skills/` folder of +[shinyobjectz/raea-skills](https://github.com/shinyobjectz/raea-skills), where the skill is written and checked. +Apache-2.0; the copied guides keep their notices (`raea/3d/NOTICE`, `raea/craft/NOTICE`). Questions and bugs: +[issues](https://github.com/shinyobjectz/raea-skills/issues). diff --git a/skills/hooks/hooks.json b/skills/hooks/hooks.json new file mode 100644 index 0000000..7803ac6 --- /dev/null +++ b/skills/hooks/hooks.json @@ -0,0 +1,28 @@ +{ + "hooks": { + "PreToolUse": [ + { + "matcher": "Bash", + "hooks": [ + { + "type": "command", + "command": "\"${CLAUDE_PLUGIN_ROOT}\"/hooks/raea-hook.sh", + "timeout": 30 + } + ] + } + ], + "PostToolUse": [ + { + "matcher": "Write|Edit|MultiEdit", + "hooks": [ + { + "type": "command", + "command": "\"${CLAUDE_PLUGIN_ROOT}\"/hooks/raea-hook.sh", + "timeout": 60 + } + ] + } + ] + } +} diff --git a/skills/hooks/raea-hook.sh b/skills/hooks/raea-hook.sh new file mode 100755 index 0000000..9534a53 --- /dev/null +++ b/skills/hooks/raea-hook.sh @@ -0,0 +1,10 @@ +#!/bin/sh +# The raea plugin's hooks. Claude Code hands this script the tool call on stdin, before a Bash command and after a +# file is saved, and `raea hook claude` answers it: media opened in the Mac's viewer is pointed at `raea show` once, +# and a saved composition gets raea's quick check, run locally. +# +# It does nothing when raea isn't installed, and nothing when `raea skills install` has already put the same hooks +# in ~/.claude/settings.json, so they never run twice. +command -v raea >/dev/null 2>&1 || exit 0 +grep -qs 'raea hook' ~/.claude/settings.json && exit 0 +exec raea hook claude diff --git a/skills/icon.png b/skills/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..c7ccbff0e5f360f474acaf25aede103b001f48e9 GIT binary patch literal 13203 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