Runic

91 AI & Dev skills for Claude Code, Cursor, Windsurf, VS Code, and JetBrains.
Install in seconds via MCP or as a native IDE plugin.

---

Installation

Runic supports two distribution channels: MCP protocol (recommended — works in all 5 IDEs with zero config) and native IDE plugin (VS Code Marketplace / JetBrains Marketplace).

---

via MCP

MCP (Model Context Protocol) is a standard supported by all major AI-enabled IDEs. One config, five IDEs.

Claude Code

claude mcp add --npm @diottodev/runic

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "runic": {
      "command": "npx",
      "args": ["-y", "@diottodev/runic"]
    }
  }
}

Restart Cursor after saving.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "runic": {
      "command": "npx",
      "args": ["-y", "@diottodev/runic"]
    }
  }
}

Or open Windsurf → Settings → Cascade → MCP Servers.

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "runic": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@diottodev/runic"]
    }
  }
}

Requires VS Code with Copilot, Continue, or another MCP-compatible extension.

JetBrains

Add to ~/.config/JetBrains/mcp.json:

{
  "servers": {
    "runic": {
      "command": "npx",
      "args": ["-y", "@diottodev/runic"]
    }
  }
}

Or open Settings → Tools → AI Assistant → MCP Servers. Requires JetBrains AI Assistant 2024+.

Requirement: Node.js ≥ 18 — run node --version to verify.

---

via Plugin

Install Runic as a native IDE extension — no JSON config needed.

VS Code / Cursor

# VS Code
code --install-extension runic.skills

# Cursor
cursor --install-extension runic.skills

Or search "Runic Skills" in the Extensions panel (Ctrl+Shift+X).

JetBrains

Open any JetBrains IDE (IntelliJ IDEA, WebStorm, PyCharm, GoLand...) →
Settings → Plugins → Marketplace → search "Runic" → Install → Restart.

---

How it Works

MCP distribution

The runic npm package exposes a Model Context Protocol server. When the IDE starts a session, it spawns npx @diottodev/runic as a child process via stdio. The server registers all 91 skills as MCP tools — the IDE's AI can then invoke them by name or the IDE can trigger them proactively based on context.

To publish / update on npm:

npm run build
npm publish

VS Code / Cursor plugin distribution

The extension (packages/vscode-extension/) wraps the MCP server and registers VS Code commands and context menu entries. Skills are accessible via the Command Palette (Ctrl+Shift+P → Runic: ...) and activate automatically via onLanguage / onFileSystem triggers.

To build and publish:

cd packages/vscode-extension
npm install
npx vsce package          # builds runic-skills-x.x.x.vsix
npx vsce publish          # requires PAT from marketplace.visualstudio.com

JetBrains plugin distribution

The plugin (packages/jetbrains-plugin/) is a Kotlin/Gradle project using the IntelliJ Platform Plugin SDK. It integrates with the JetBrains AI Assistant extension point and registers Runic skills as inline actions and tool window entries.

To build and publish:

cd packages/jetbrains-plugin
./gradlew buildPlugin       # outputs build/distributions/runic-*.zip
./gradlew publishPlugin     # requires PUBLISH_TOKEN env var from plugins.jetbrains.com

---

Domains & Skills

Domain	Skills	Description
engineering/	37	Core AI & dev tools — review, debug, test, LLM ops, agents
engineering-team/	38	Team skills — security, cloud, fullstack, QA, DevOps
ai-research/	2	Model evaluation & benchmarks
ai-security/	1	Prompt injection & hardening
research/	8	Academic & market research
research-ops/	5	Clinical, market, product & R&D ops

Engineering highlights

code-review · debug-error · explain-code · generate-tests · git-commit · refactor · write-docs · llm-cost-optimizer · prompt-engineering · agent-designer · rag-architect · mcp-server-builder · karpathy-coder · chaos-engineering · ship-gate · slo-architect · docker-development · kubernetes-operator · terraform-patterns

Security highlights

ai-security · cloud-security · red-team · security-pen-testing · threat-detection · prompt-injection · senior-secops · incident-response

---

Project Structure

runic/
├── engineering/          # 37 core AI & dev skills
├── engineering-team/     # 38 team role skills + security
├── ai-research/          # 2 model evaluation skills
├── ai-security/          # 1 AI security skill
├── research/             # 8 research skills
├── research-ops/         # 5 research ops skills
│
├── packages/
│   ├── vscode-extension/ # VS Code / Cursor native plugin
│   └── jetbrains-plugin/ # JetBrains IDE native plugin
│
├── web/                  # Landing page (React + Vite + Tailwind)
│
├── CLAUDE.md             # Navigation & roadmap
├── SKILL-AUTHORING-STANDARD.md  # 10-Pattern Framework
├── CONVENTIONS.md
├── CONTRIBUTING.md
└── CHANGELOG.md

---

Contributing

See CONTRIBUTING.md. AI and Dev skills only. PRs target dev.

License

MIT — Diottodev