rei-skills 1.0.0

package/README.md

@@ -0,0 +1,322 @@
+# 🏰 Rei Skills — 883+ Universal Agentic Skills
+
+> **The Ultimate Collection of 883+ Universal Agentic Skills for AI Coding Assistants — Curated by Rootcastle Engineering & Innovation (REI) | Batuhan Ayrıbaş**
+
+[![Rootcastle](https://img.shields.io/badge/Rootcastle-Engineering-blue?style=for-the-badge)](https://www.rootcastle.com)
+[![npm](https://img.shields.io/badge/npm-rei--skills-red?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/rei-skills)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
+[![Skills](https://img.shields.io/badge/Skills-883+-green?style=for-the-badge)]()
+
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)](https://claude.ai)
+[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Google-blue)](https://github.com/google-gemini/gemini-cli)
+[![Codex CLI](https://img.shields.io/badge/Codex%20CLI-OpenAI-green)](https://github.com/openai/codex)
+[![Cursor](https://img.shields.io/badge/Cursor-AI%20IDE-orange)](https://cursor.sh)
+[![Copilot](https://img.shields.io/badge/GitHub%20Copilot-VSCode-lightblue)](https://github.com/features/copilot)
+[![Antigravity](https://img.shields.io/badge/Antigravity-DeepMind-red)](https://github.com/rootcastleco/rei-skills)
+
+---
+
+## 🏰 About Rootcastle Engineering & Innovation
+
+**Rootcastle** is an international technology company that unifies engineering disciplines under a single architecture. With our software and R&D center in **Estonia** integrated with manufacturing, hardware development, and engineering capabilities in **Turkey**, we develop reliable, flexible, and scalable technologies.
+
+Our expertise spans **software development**, **PCB & hardware design**, **embedded systems**, **IoT & GPS telematics**, **data security**, **3D manufacturing**, **rapid prototyping**, and **e-commerce integrations**. This infrastructure serves industries from logistics and manufacturing to public services, security, fleet management, and critical monitoring operations.
+
+Under brands like **jTrack** and **NetFleet**, we support container security solutions (HSCTS), fleet telemetry devices, OBD-II product families, solar asset tracking systems, and mobile monitoring units. Through our technology partners in the **UK** and **US**, our platforms deliver cloud architectures, mobile applications, and modern API integrations.
+
+> **🌍 5 International Partnerships | 150+ Global Projects**  
+> **🔗 Website:** [www.rootcastle.com](https://www.rootcastle.com)  
+> **📧 Contact:** admin@rootcastle.com  
+> **📱 Phone:** +90 507 545 29 39
+
+---
+
+## Table of Contents
+
+- [⚡ Quick Start](#quick-start)
+- [📖 Complete Usage Guide](docs/USAGE.md)
+- [🔌 Compatibility & Invocation](#compatibility--invocation)
+- [🛠️ Installation](#installation)
+- [🧯 Troubleshooting](#troubleshooting)
+- [🎁 Curated Collections (Bundles)](#curated-collections)
+- [🧭 Workflows](#workflows)
+- [📦 Features & Categories](#features--categories)
+- [📚 Browse 883+ Skills](#browse-883-skills)
+- [🔒 Security](#security)
+- [🤝 How to Contribute](#how-to-contribute)
+- [👥 Credits & Sources](#credits--sources)
+- [⚖️ License](#license)
+
+---
+
+## Quick Start
+
+Install once, use everywhere. Get 883+ skills in your AI coding assistant in under a minute.
+
+### 1. Install
+
+```bash
+# Default: ~/.gemini/rei/skills (Global)
+npx rei-skills
+
+# Or choose your platform:
+npx rei-skills --claude       # Claude Code
+npx rei-skills --gemini       # Gemini CLI
+npx rei-skills --cursor       # Cursor IDE
+npx rei-skills --codex        # Codex CLI
+npx rei-skills --antigravity  # Antigravity IDE
+```
+
+### 2. Verify
+
+```bash
+test -d ~/.gemini/rei/skills && echo "✅ Rei Skills installed successfully"
+```
+
+### 3. Use Your First Skill
+
+> "Use **@brainstorming** to plan a SaaS MVP."
+
+### 4. Pick a Bundle
+
+- **Web Dev?** → Start with `Web Wizard`
+- **Security?** → Start with `Security Engineer`  
+- **General?** → Start with `Essentials`
+
+👉 **[Complete Usage Guide](docs/USAGE.md)** — Start here after installation  
+👉 **[Bundles Guide](docs/BUNDLES.md)** — Curated skill packs by role
+
+---
+
+## Compatibility & Invocation
+
+Rei Skills follow the universal **SKILL.md** format and work with any AI coding assistant that supports agentic skills.
+
+| Tool            | Type | Invocation Example                | Path              |
+| :-------------- | :--- | :-------------------------------- | :---------------- |
+| **Claude Code** | CLI  | `>> /skill-name help me...`       | `.claude/skills/` |
+| **Gemini CLI**  | CLI  | `(User Prompt) Use skill-name...` | `.gemini/skills/` |
+| **Codex CLI**   | CLI  | `(User Prompt) Use skill-name...` | `.codex/skills/`  |
+| **Antigravity** | IDE  | `(Agent Mode) Use skill...`       | Global: `~/.gemini/rei/skills/` · Workspace: `.agent/skills/` |
+| **Cursor**      | IDE  | `@skill-name (in Chat)`           | `.cursor/skills/` |
+| **Copilot**     | Ext  | `(Paste content manually)`        | N/A               |
+| **OpenCode**    | CLI  | `opencode run @skill-name`        | `.agents/skills/`  |
+| **AdaL CLI**    | CLI  | `(Auto) Skills load on-demand`    | `.adal/skills/`   |
+
+> [!TIP]
+> **Default installer path**: `~/.gemini/rei/skills` (Global). Use `--path ~/.agent/skills` for workspace-specific install.
+
+> [!WARNING]
+> **Windows Users**: This repository uses **symlinks** for official skills. Enable Developer Mode or run Git as Administrator. See [Troubleshooting](#troubleshooting).
+
+---
+
+## Installation
+
+### Option A: npx (Recommended)
+
+```bash
+# Default: ~/.gemini/rei/skills (Global)
+npx rei-skills
+
+# Claude Code
+npx rei-skills --claude
+
+# Gemini CLI
+npx rei-skills --gemini
+
+# Codex CLI
+npx rei-skills --codex
+
+# Cursor
+npx rei-skills --cursor
+
+# Antigravity IDE
+npx rei-skills --antigravity
+
+# OpenCode
+npx rei-skills --path .agents/skills
+
+# Custom path
+npx rei-skills --path ./my-skills
+```
+
+Run `npx rei-skills --help` for all options.
+
+### Option B: Git Clone
+
+```bash
+# Global (matches npx default)
+git clone https://github.com/rootcastleco/rei-skills.git ~/.gemini/rei/skills
+
+# Workspace-specific
+git clone https://github.com/rootcastleco/rei-skills.git .agent/skills
+
+# Claude Code
+git clone https://github.com/rootcastleco/rei-skills.git .claude/skills
+
+# Gemini CLI
+git clone https://github.com/rootcastleco/rei-skills.git .gemini/skills
+
+# Cursor
+git clone https://github.com/rootcastleco/rei-skills.git .cursor/skills
+```
+
+---
+
+## Troubleshooting
+
+### `npx rei-skills` returns 404
+
+Use the GitHub package fallback:
+
+```bash
+npx github:rootcastle/rei-skills
+```
+
+### Windows clone issues (symlinks)
+
+```bash
+git clone -c core.symlinks=true https://github.com/rootcastleco/rei-skills.git .agent/skills
+```
+
+### Skills installed but not detected
+
+Install to the tool-specific path using the installer flags: `--claude`, `--gemini`, `--codex`, `--cursor`, `--antigravity`, or `--path <dir>`.
+
+### Update an existing installation
+
+```bash
+git -C ~/.gemini/rei/skills pull
+```
+
+### Reinstall from scratch
+
+```bash
+rm -rf ~/.gemini/rei/skills
+npx rei-skills
+```
+
+---
+
+## Curated Collections
+
+**Bundles** are curated groups of skills for specific roles (e.g., `Web Wizard`, `Security Engineer`, `OSS Maintainer`).
+
+> **Bundles are NOT separate installations.** You already have all skills after one install. Bundles are simply recommended lists to help you focus.
+
+### How to use bundles:
+
+1. **Install the repository once** (all 883+ skills included)
+2. **Browse bundles** in [docs/BUNDLES.md](docs/BUNDLES.md)
+3. **Pick 3-5 skills** from a bundle to start
+4. **Reference them** in your conversations: `"Use @brainstorming..."`
+
+### Examples:
+
+- **Building a SaaS MVP:** `Essentials` + `Full-Stack Developer` + `QA & Testing`
+- **Hardening production:** `Security Developer` + `DevOps & Cloud` + `Observability`
+- **Shipping OSS changes:** `Essentials` + `OSS Maintainer`
+
+---
+
+## Workflows
+
+Bundles help you choose skills. Workflows help you execute them in order.
+
+- [docs/WORKFLOWS.md](docs/WORKFLOWS.md) — Human-readable playbooks
+- [data/workflows.json](data/workflows.json) — Machine-readable workflow metadata
+
+**Available Workflows:**
+
+- 🚀 Ship a SaaS MVP
+- 🔒 Security Audit for a Web App
+- 🤖 Build an AI Agent System
+- 🧪 QA and Browser Automation
+
+---
+
+## Features & Categories
+
+| Category       | Focus                                              | Example Skills                                                     |
+| :------------- | :------------------------------------------------- | :----------------------------------------------------------------- |
+| Architecture   | System design, ADRs, C4, scalable patterns         | `architecture`, `c4-context`, `senior-architect`                   |
+| Business       | Growth, pricing, CRO, SEO, go-to-market            | `copywriting`, `pricing-strategy`, `seo-audit`                     |
+| Data & AI      | LLM apps, RAG, agents, observability               | `rag-engineer`, `prompt-engineer`, `langgraph`                     |
+| Development    | Languages, frameworks, code quality                | `typescript-expert`, `python-patterns`, `react-patterns`           |
+| General        | Planning, docs, product ops, writing               | `brainstorming`, `doc-coauthoring`, `writing-plans`                |
+| Infrastructure | DevOps, cloud, serverless, CI/CD                   | `docker-expert`, `aws-serverless`, `vercel-deployment`             |
+| Security       | AppSec, pentesting, vuln analysis, compliance      | `api-security-best-practices`, `vulnerability-scanner`             |
+| Testing        | TDD, test design, QA workflows                     | `test-driven-development`, `testing-patterns`, `test-fixing`       |
+| Workflow       | Automation, orchestration, agents                  | `workflow-automation`, `inngest`, `trigger-dev`                    |
+
+---
+
+## Browse 883+ Skills
+
+👉 **[View the Complete Skill Catalog (CATALOG.md)](CATALOG.md)**
+
+---
+
+## Security
+
+All skills are audited for security vulnerabilities, hardcoded credentials, and dangerous commands.
+
+- [Security Policy](SECURITY.md)
+- [Security Guardrails](docs/SECURITY_GUARDRAILS.md)
+- [Community Guidelines](docs/COMMUNITY_GUIDELINES.md)
+
+Offensive security skills (penetration testing, red teaming) are included for **authorized educational and professional use only**.
+
+---
+
+## How to Contribute
+
+1. **Fork** the repository
+2. **Create a new directory** inside `skills/` for your skill
+3. **Add a `SKILL.md`** with the required frontmatter (`name`, `description`, `risk`, `source`). See [docs/SKILL_ANATOMY.md](docs/SKILL_ANATOMY.md) and [docs/QUALITY_BAR.md](docs/QUALITY_BAR.md).
+4. **Run validation**: `npm run validate`
+5. **Submit a Pull Request**
+
+---
+
+## Credits & Sources
+
+This collection stands on the shoulders of the open-source community. Full attribution is preserved in **[CREDITS.md](CREDITS.md)**.
+
+Key sources include:
+
+- **[anthropics/skills](https://github.com/anthropics/skills)** — Official Anthropic skills
+- **[microsoft/skills](https://github.com/microsoft/skills)** — Official Microsoft skills
+- **[openai/skills](https://github.com/openai/skills)** — Official OpenAI Codex skills
+- **[google-gemini/gemini-skills](https://github.com/google-gemini/gemini-skills)** — Official Gemini skills
+- **[vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills)** — Vercel Labs skills
+- **[supabase/agent-skills](https://github.com/supabase/agent-skills)** — Supabase skills
+- **The Open Source Community** — 300+ community contributors
+
+---
+
+## Author
+
+**Batuhan Ayrıbaş**  
+Founder & Lead Engineer — Rootcastle Engineering & Innovation (REI)
+
+- 🌐 [www.rootcastle.com](https://www.rootcastle.com)
+- 📧 admin@rootcastle.com
+- 📱 +90 507 545 29 39
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+<div align="center">
+
+**🏰 Rei Skills — Engineering Beyond Boundaries**
+
+*Curated by [Rootcastle Engineering & Innovation](https://www.rootcastle.com) | © REI 2025. All rights reserved.*
+
+</div>

package/bin/install.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+const os = require("os");
+
+// ============================================================================
+// 🏰 Rei Skills — Rootcastle Engineering & Innovation
+// Curated by Batuhan Ayrıbaş | www.rootcastle.com
+// ============================================================================
+
+const REPO = "https://github.com/rootcastleco/rei-skills.git";
+const HOME = process.env.HOME || process.env.USERPROFILE || "";
+const BRAND = "rei";
+
+function resolveDir(p) {
+  if (!p) return null;
+  const s = p.replace(/^~($|\/)/, HOME + "$1");
+  return path.resolve(s);
+}
+
+function parseArgs() {
+  const a = process.argv.slice(2);
+  let pathArg = null;
+  let versionArg = null;
+  let tagArg = null;
+  let cursor = false,
+    claude = false,
+    gemini = false,
+    codex = false,
+    antigravity = false;
+
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] === "--help" || a[i] === "-h") return { help: true };
+    if (a[i] === "--path" && a[i + 1]) {
+      pathArg = a[++i];
+      continue;
+    }
+    if (a[i] === "--version" && a[i + 1]) {
+      versionArg = a[++i];
+      continue;
+    }
+    if (a[i] === "--tag" && a[i + 1]) {
+      tagArg = a[++i];
+      continue;
+    }
+    if (a[i] === "--cursor") {
+      cursor = true;
+      continue;
+    }
+    if (a[i] === "--claude") {
+      claude = true;
+      continue;
+    }
+    if (a[i] === "--gemini") {
+      gemini = true;
+      continue;
+    }
+    if (a[i] === "--codex") {
+      codex = true;
+      continue;
+    }
+    if (a[i] === "--antigravity") {
+      antigravity = true;
+      continue;
+    }
+    if (a[i] === "install") continue;
+  }
+
+  return {
+    pathArg,
+    versionArg,
+    tagArg,
+    cursor,
+    claude,
+    gemini,
+    codex,
+    antigravity,
+  };
+}
+
+function defaultDir(opts) {
+  if (opts.pathArg) return resolveDir(opts.pathArg);
+  if (opts.cursor) return path.join(HOME, ".cursor", "skills");
+  if (opts.claude) return path.join(HOME, ".claude", "skills");
+  if (opts.gemini) return path.join(HOME, ".gemini", "skills");
+  if (opts.codex) {
+    const codexHome = process.env.CODEX_HOME;
+    if (codexHome) return path.join(codexHome, "skills");
+    return path.join(HOME, ".codex", "skills");
+  }
+  if (opts.antigravity)
+    return path.join(HOME, ".gemini", BRAND, "skills");
+  // Default: ~/.gemini/rei/skills
+  return path.join(HOME, ".gemini", BRAND, "skills");
+}
+
+function printHelp() {
+  console.log(`
+🏰 rei-skills — Rootcastle Engineering & Innovation
+   Curated by Batuhan Ayrıbaş | www.rootcastle.com
+
+  npx rei-skills [install] [options]
+
+  Installs 883+ universal agentic skills into your AI assistant's skills directory.
+
+Options:
+  --cursor       Install to ~/.cursor/skills (Cursor)
+  --claude       Install to ~/.claude/skills (Claude Code)
+  --gemini       Install to ~/.gemini/skills (Gemini CLI)
+  --codex        Install to ~/.codex/skills (Codex CLI)
+  --antigravity  Install to ~/.gemini/${BRAND}/skills (Antigravity)
+  --path <dir>   Install to <dir> (default: ~/.gemini/${BRAND}/skills)
+  --version <ver>  After clone, checkout tag v<ver> (e.g. 1.0.0 -> v1.0.0)
+  --tag <tag>      After clone, checkout this tag (e.g. v1.0.0)
+
+Examples:
+  npx rei-skills
+  npx rei-skills --cursor
+  npx rei-skills --claude
+  npx rei-skills --antigravity
+  npx rei-skills --version 1.0.0
+  npx rei-skills --path ./my-skills
+
+🌐 https://www.rootcastle.com | admin@rootcastle.com
+`);
+}
+
+function copyRecursiveSync(src, dest, skipGit = true) {
+  const stats = fs.statSync(src);
+  if (stats.isDirectory()) {
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, { recursive: true });
+    }
+    fs.readdirSync(src).forEach((child) => {
+      if (skipGit && child === ".git") return;
+      copyRecursiveSync(path.join(src, child), path.join(dest, child), skipGit);
+    });
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+}
+
+/** Copy contents of repo's skills/ into target so each skill is target/skill-name/ */
+function installSkillsIntoTarget(tempDir, target) {
+  const repoSkills = path.join(tempDir, "skills");
+  if (!fs.existsSync(repoSkills)) {
+    console.error("Cloned repo has no skills/ directory.");
+    process.exit(1);
+  }
+  fs.readdirSync(repoSkills).forEach((name) => {
+    const src = path.join(repoSkills, name);
+    const dest = path.join(target, name);
+    copyRecursiveSync(src, dest);
+  });
+  const repoDocs = path.join(tempDir, "docs");
+  if (fs.existsSync(repoDocs)) {
+    const docsDest = path.join(target, "docs");
+    if (!fs.existsSync(docsDest)) fs.mkdirSync(docsDest, { recursive: true });
+    copyRecursiveSync(repoDocs, docsDest);
+  }
+}
+
+function run(cmd, args, opts = {}) {
+  const r = spawnSync(cmd, args, { stdio: "inherit", ...opts });
+  if (r.status !== 0) process.exit(r.status == null ? 1 : r.status);
+}
+
+function main() {
+  const opts = parseArgs();
+  const { tagArg, versionArg } = opts;
+
+  if (opts.help) {
+    printHelp();
+    return;
+  }
+
+  console.log("\n🏰 Rei Skills — Rootcastle Engineering & Innovation");
+  console.log("   Curated by Batuhan Ayrıbaş | www.rootcastle.com\n");
+
+  const target = defaultDir(opts);
+  if (!target || !HOME) {
+    console.error(
+      "Could not resolve home directory. Use --path <absolute-path>.",
+    );
+    process.exit(1);
+  }
+
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "rei-skills-"));
+  const originalCwd = process.cwd();
+
+  try {
+    if (process.platform === "win32") {
+      run("git", ["-c", "core.symlinks=true", "clone", REPO, tempDir]);
+    } else {
+      run("git", ["clone", REPO, tempDir]);
+    }
+
+    const ref =
+      tagArg ||
+      (versionArg
+        ? versionArg.startsWith("v")
+          ? versionArg
+          : `v${versionArg}`
+        : null);
+    if (ref) {
+      console.log(`Checking out ${ref}…`);
+      process.chdir(tempDir);
+      run("git", ["checkout", ref]);
+      process.chdir(originalCwd);
+    }
+
+    if (fs.existsSync(target)) {
+      const gitDir = path.join(target, ".git");
+      if (fs.existsSync(gitDir)) {
+        console.log("Migrating from full-repo install to skills-only layout…");
+        const entries = fs.readdirSync(target);
+        for (const name of entries) {
+          const full = path.join(target, name);
+          const stat = fs.statSync(full);
+          if (stat.isDirectory()) {
+            if (fs.rmSync) {
+              fs.rmSync(full, { recursive: true, force: true });
+            } else {
+              fs.rmdirSync(full, { recursive: true });
+            }
+          } else {
+            fs.unlinkSync(full);
+          }
+        }
+      } else {
+        console.log(`Updating existing install at ${target}…`);
+      }
+    } else {
+      const parent = path.dirname(target);
+      if (!fs.existsSync(parent)) {
+        try {
+          fs.mkdirSync(parent, { recursive: true });
+        } catch (e) {
+          console.error(`Cannot create parent directory: ${parent}`, e.message);
+          process.exit(1);
+        }
+      }
+      fs.mkdirSync(target, { recursive: true });
+    }
+
+    installSkillsIntoTarget(tempDir, target);
+
+    console.log(`\n✅ Rei Skills installed to ${target}`);
+    console.log(
+      "📦 Pick a bundle in docs/BUNDLES.md and use @skill-name in your AI assistant.",
+    );
+    console.log(
+      "🌐 www.rootcastle.com | Engineering Beyond Boundaries\n",
+    );
+  } finally {
+    try {
+      if (fs.existsSync(tempDir)) {
+        if (fs.rmSync) {
+          fs.rmSync(tempDir, { recursive: true, force: true });
+        } else {
+          fs.rmdirSync(tempDir, { recursive: true });
+        }
+      }
+    } catch (e) {
+      // ignore cleanup errors
+    }
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "rei-skills",
+  "version": "1.0.0",
+  "description": "883+ Universal Agentic Skills for Claude Code, Gemini CLI, Cursor & More — Curated by Rootcastle Engineering & Innovation (REI) | Batuhan Ayrıbaş",
+  "author": "Batuhan Ayrıbaş <admin@rootcastle.com> (https://www.rootcastle.com)",
+  "homepage": "https://www.rootcastle.com",
+  "license": "MIT",
+  "scripts": {
+    "validate": "python3 scripts/validate_skills.py",
+    "validate:strict": "python3 scripts/validate_skills.py --strict",
+    "index": "python3 scripts/generate_index.py",
+    "readme": "python3 scripts/update_readme.py",
+    "chain": "npm run validate && npm run index && npm run readme",
+    "catalog": "node scripts/build-catalog.js",
+    "build": "npm run chain && npm run catalog",
+    "test": "node scripts/tests/validate_skills_headings.test.js && python3 scripts/tests/test_validate_skills_headings.py && python3 scripts/tests/inspect_microsoft_repo.py && python3 scripts/tests/test_comprehensive_coverage.py",
+    "brand": "node scripts/brand_skills.js",
+    "security-audit": "node scripts/security_audit.js",
+    "sync:microsoft": "python3 scripts/sync_microsoft_skills.py",
+    "sync:all-official": "npm run sync:microsoft && npm run chain"
+  },
+  "devDependencies": {
+    "yaml": "^2.8.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rootcastleco/rei-skills.git"
+  },
+  "bin": {
+    "rei-skills": "bin/install.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "keywords": [
+    "rei-skills",
+    "rootcastle",
+    "claude-code",
+    "cursor",
+    "gemini-cli",
+    "agentic-skills",
+    "ai-coding",
+    "ai-agents",
+    "engineering",
+    "iot",
+    "cybersecurity"
+  ]
+}