Skip to content

skills/ is raea's plugin for Claude - #49

Merged
shinyobjectz merged 1 commit into
mainfrom
claude-plugin
Nov 13, 2026
Merged

shinyobjectz merged 1 commit into
mainfrom
claude-plugin

Conversation

@shinyobjectz

Copy link
Copy Markdown
Owner

Makes skills/ raea's plugin for Claude, so it can be listed in Claude's plugin directory (claude.ai/directory) and installed in Claude Code, Cowork and claude.ai.

What the plugin holds

  • skills/.claude-plugin/plugin.json: plugin raea, skills: ["./raea"], plus the directory listing's icon, docs, support, privacy and terms links.
  • skills/hooks/hooks.json + hooks/raea-hook.sh: raea's two hooks (raea hook claude). Before a Bash command, media opened in the Mac's viewer is pointed at raea show once. After a save, a composition gets raea check --quick. The script does nothing without raea on PATH, and steps aside when raea skills install already put the hooks in ~/.claude/settings.json.
  • skills/README.md: what the plugin is, how to install it and raea, and what it runs and sends (the directory reads it for the listing and the security scan).
  • skills/icon.png: raea's app icon.
  • .claude-plugin/marketplace.json: this repository as a marketplace, so /plugin install raea --marketplace shinyobjectz/raea-skills works today.

Checks

  • skillcheck reads the manifest (features/plugin.feature, 5 scenarios). It must parse and name the plugin, its skills must list every skill folder and nothing that isn't one, and hooks/ isn't a skill.
  • just link skips folders with no SKILL.md.
  • just plugin runs claude plugin validate on the plugin and the marketplace.

Tested

  • just ci: 17 scenarios, 89 steps, and 1 skill checked with 0 errors.
  • claude plugin validate skills and . both pass, and the directory checks found nothing to report. The one warning is version, left out on purpose so each commit is the plugin's version.
  • The hook script exits 0 silently without raea on PATH and with raea's hooks already in settings. Otherwise it stops open out/a.png once (exit 2, pointing to raea show) and lets the same command through the second time. On a saved composition it returns the quick check's findings as additionalContext.
  • A claude --plugin-dir skills session lists raea:raea and runs the plugin's PreToolUse hook.

Order with raea: shinyobjectz/raea#123 makes tools/release.sh stage only skill folders. Land it before raea's skills pin moves past this merge, so the plugin's files never reach ~/.claude/skills through raea's installer.

Review checklist

  • just ci passes
  • Description says what AND when (unchanged skill)
  • No taste in the skill (no skill text changed)
  • Every opinion-ok has a reason a reviewer agrees with (none added)
  • raea-tested-against matches upstream/raea/VERSION (unchanged)
  • Tried live in a fresh session (claude --plugin-dir skills)

…oks, 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.
@shinyobjectz
shinyobjectz merged commit d740ca6 into main Nov 13, 2026
1 check passed
@shinyobjectz
shinyobjectz deleted the claude-plugin branch November 13, 2026 02:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant