renku-skills

Renku Skills

This repository is a standalone skills/plugin package for working with the Renku CLI.

It was split out from the main Renku codebase so teams can install and share just the skills layer without distributing the full repository.

Important: these skills assume you already have the Renku CLI installed and configured. Without the CLI, they are not useful.

Install Renku CLI first

• Website: https://gorenku.com
• Source code: https://github.com/keremk/renku

After installing, verify:

renku --version

If this is your first Renku setup, initialize your workspace:

renku init --root=~/renku-workspace

What is in this repo

.
├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── agents/
│   ├── director-prompt-engineer.md
│   └── model-picker.md
└── skills/
    ├── create-blueprint/
    ├── director-prompt-engineer/
    └── model-picker/

• skills/ contains the reusable skill definitions (SKILL.md + references)
• agents/ contains Claude Code subagents used by the skills
• .claude-plugin/plugin.json is the Claude Code plugin manifest
• .claude-plugin/marketplace.json lets you install this plugin through Claude's marketplace flow (local or Git-hosted)

Quick start

1. Clone this repository.
2. Install and verify Renku CLI (above).
3. Install skills in your coding tool of choice (sections below).

Install in Claude Code CLI

You can use either a session-only load or an installed plugin.

Option A: Session-only (fastest)

claude --plugin-dir /absolute/path/to/this/repo

Option B: Installed plugin (recommended)

Inside Claude Code, run:

/plugin marketplace add /absolute/path/to/this/repo
/plugin install renku-plugin@renku-skills

Then reload plugins:

/reload-plugins

Use skills with namespaced commands such as:

/renku-plugin:create-blueprint

Install in Claude Code desktop app

Claude Code desktop uses the same plugin system as CLI.

1. Open a local Code session.
2. Use either:
   • the Plugins menu in the + prompt menu, or
   • slash commands (/plugin ...) directly in the session.
3. Add/install this plugin with:

/plugin marketplace add /absolute/path/to/this/repo
/plugin install renku-plugin@renku-skills
/reload-plugins

Install in Codex CLI

Codex loads skills from ~/.agents/skills (user scope) and from .agents/skills in repositories.

Recommended (from this repo root):

./scripts/install-codex-skills.sh

To remove only the symlinks created by this repo later:

./scripts/uninstall-codex-skills.sh

Manual equivalent:

mkdir -p ~/.agents/skills
for s in /absolute/path/to/this/repo/skills/*; do ln -sfn "$s" ~/.agents/skills/"$(basename "$s")"; done

Then start Codex and verify skills are visible:

/skills

Invoke directly with skill syntax, for example:

$create-blueprint

Install in Codex app

Codex app uses the same skill locations as Codex CLI.

1. Install skills to ~/.agents/skills (use ./scripts/install-codex-skills.sh).
2. Open/restart Codex app.
3. Open Skills in the sidebar to confirm they loaded.
4. Invoke with $<skill-name> (for example, $create-blueprint).

Notes on compatibility

• Claude Code uses this repo as a plugin (.claude-plugin, agents/, skills/).
• Codex consumes the skills/* directories via .agents/skills or ~/.agents/skills.
• The same skill content is shared across both tools.