@diottodev/runic 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 mcp-skills-server contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+# 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.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/@diottodev/runic)](https://www.npmjs.com/package/@diottodev/runic)
+[![Skills](https://img.shields.io/badge/skills-91-0e7490)](.)
+[![Domains](https://img.shields.io/badge/domains-6-155e75)](.)
+[![GitHub](https://img.shields.io/badge/GitHub-Diottodev-161b22?logo=github)](https://github.com/Diottodev/runic)
+
+---
+
+## 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
+
+```bash
+claude mcp add --npm @diottodev/runic
+```
+
+#### Cursor
+
+Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
+
+```json
+{
+  "mcpServers": {
+    "runic": {
+      "command": "npx",
+      "args": ["-y", "@diottodev/runic"]
+    }
+  }
+}
+```
+
+Restart Cursor after saving.
+
+#### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "runic": {
+      "command": "npx",
+      "args": ["-y", "@diottodev/runic"]
+    }
+  }
+}
+```
+
+Or open Windsurf → Settings → Cascade → MCP Servers.
+
+#### VS Code
+
+Add to `.vscode/mcp.json`:
+
+```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`:
+
+```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
+
+```bash
+# 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](https://modelcontextprotocol.io) 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:**
+
+```bash
+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:**
+
+```bash
+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](https://plugins.jetbrains.com/docs/intellij/). It integrates with the JetBrains AI Assistant extension point and registers Runic skills as inline actions and tool window entries.
+
+**To build and publish:**
+
+```bash
+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](./CONTRIBUTING.md). AI and Dev skills only. PRs target `dev`.
+
+## License
+
+MIT — [Diottodev](https://github.com/Diottodev/runic)

package/dist/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { readFileSync, readdirSync, statSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { z } from 'zod';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..');
+const DOMAINS = [
+    'engineering',
+    'engineering-team',
+    'ai-research',
+    'ai-security',
+    'research',
+    'research-ops',
+];
+function parseFrontmatter(raw) {
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/m);
+    if (!match)
+        return { body: raw };
+    const meta = {};
+    for (const line of match[1].split('\n')) {
+        const colon = line.indexOf(':');
+        if (colon === -1)
+            continue;
+        const key = line.slice(0, colon).trim();
+        const val = line.slice(colon + 1).trim().replace(/^["']|["']$/g, '');
+        meta[key] = val;
+    }
+    return { name: meta['name'], description: meta['description'], body: match[2].trim() };
+}
+function findSkillFiles(dir) {
+    if (!existsSync(dir))
+        return [];
+    const results = [];
+    for (const entry of readdirSync(dir)) {
+        const full = join(dir, entry);
+        if (statSync(full).isDirectory()) {
+            const skill = join(full, 'SKILL.md');
+            if (existsSync(skill))
+                results.push(skill);
+            else
+                results.push(...findSkillFiles(full));
+        }
+    }
+    return results;
+}
+function loadSkills() {
+    const skills = [];
+    const seen = new Set();
+    for (const domain of DOMAINS) {
+        const domainDir = join(ROOT, domain);
+        for (const file of findSkillFiles(domainDir)) {
+            const raw = readFileSync(file, 'utf8');
+            const { name, description, body } = parseFrontmatter(raw);
+            if (!name || !description || !body || seen.has(name))
+                continue;
+            seen.add(name);
+            skills.push({ name, description, content: body, domain });
+        }
+    }
+    return skills;
+}
+async function main() {
+    const skills = loadSkills();
+    const server = new McpServer({
+        name: 'runic',
+        version: '1.0.0',
+    });
+    for (const skill of skills) {
+        server.tool(skill.name, skill.description, { context: z.string().optional().describe('Additional context from the user') }, async ({ context }) => ({
+            content: [{
+                    type: 'text',
+                    text: context
+                        ? `${skill.content}\n\n---\nUser context: ${context}`
+                        : skill.content,
+                }],
+        }));
+    }
+    // List all skills tool
+    server.tool('runic-list', 'List all available Runic skills with their names, domains, and descriptions.', {}, async () => ({
+        content: [{
+                type: 'text',
+                text: skills
+                    .map(s => `**${s.name}** (${s.domain})\n${s.description}`)
+                    .join('\n\n'),
+            }],
+    }));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(err => {
+    process.stderr.write(`runic: ${err.message}\n`);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@diottodev/runic",
+  "version": "1.0.0",
+  "description": "91 AI & Dev skills for Claude Code, Cursor, Windsurf, VS Code, and JetBrains — install via MCP or as a native IDE plugin.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "runic": "./dist/index.js",
+    "@diottodev/runic": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/index.js",
+    "prepare": "npm run build",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "runic",
+    "claude-code",
+    "cursor",
+    "windsurf",
+    "vscode",
+    "jetbrains",
+    "ide-plugin",
+    "vscode-extension",
+    "ai",
+    "ai-skills",
+    "code-review",
+    "developer-tools",
+    "llm",
+    "model-context-protocol",
+    "prompt-engineering",
+    "debug",
+    "test-generation",
+    "skills-library"
+  ],
+  "homepage": "https://github.com/Diottodev/runic",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Diottodev/runic.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Diottodev/runic/issues"
+  },
+  "author": "Diottodev",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "shx": "^0.3.4",
+    "tsx": "^4.15.0",
+    "typescript": "^5.5.0",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}