ruledrop

Unified CLI manager for AI coding agent skill/prompt files. Install, remove, and browse community skills across Cursor, Windsurf, Claude Code, GitHub Copilot, Kiro, Antigravity, and more — all from one tool.

What it does

AI coding tools each have their own location for prompt/instruction files. Ruledrop detects which tools you use and writes skills to the right place automatically, so one install covers all your agents.

| IDE | Where skills are written | | --- | --- | | All | .ruledrop/skills/<skill>.md (canonical store) | | Cursor | .cursor/rules/<skill>.mdc | | Kiro | .kiro/steering/<skill>.md | | VS Code | .vscode/instructions/<skill>.instructions.md | | Zed | .zed/rules/<skill>.md | | Trae | .trae/rules/<skill>.md | | Void | .void/rules/<skill>.md | | Windsurf | .windsurfrules (appended) | | Claude Code | CLAUDE.md (appended) | | GitHub Copilot | .github/copilot-instructions.md (appended) | | Cline | .clinerules (appended) | | Antigravity | .antigravity/rules.md (appended) | | Gemini CLI | GEMINI.md (appended) | | OpenAI Codex CLI | AGENTS.md (appended) | | Warp | .warp/rules.md (appended) | | Continue | .continue/rules.md (appended) | | Aider | .aider.conf.md (appended) | | OpenCode | OPENCODE.md (appended) |

If no IDEs are detected during ruledrop init, ruledrop defaults to VS Code automatically.

Installation

npm install -g ruledrop

Or without installing:

npx ruledrop <command>

Quick start

cd my-project
ruledrop init
ruledrop install frontend-patterns
ruledrop install-set frontend
ruledrop dashboard

Commands

ruledrop init

Detects AI tools in the current directory and creates a skills.json registry.

ruledrop install <name>

Fetches a skill from the community marketplace and writes it to all detected IDEs.

ruledrop install frontend-patterns
ruledrop install typescript-strict --force

ruledrop remove <name>

Removes a skill from all IDE config files and the registry.

ruledrop remove frontend-patterns

ruledrop install-set <name>

Installs all skills in a community set.

ruledrop install-set frontend
ruledrop install-set nextjs-fullstack --force

ruledrop dashboard

Starts a local web server at http://localhost:47891 and opens the dashboard.

• Browse and read community skills and sets
• Click any card to open a full detail page with Markdown preview
• Install skills directly from the detail page
• Edit button — installs a skill and opens it in the built-in Markdown editor
• My Skills tab — create and manage local custom skills
• Sets tab — browse community sets and create custom sets

The registry (skills.json)

{
  "detectedIDEs": ["cursor", "kiro"],
  "installedSkills": [
    {
      "name": "frontend-patterns",
      "sourceUrl": "https://raw.githubusercontent.com/CR-8/ruledrop-community/main/skills/frontend-patterns/skill.md",
      "installedAt": "2024-01-15T10:30:00.000Z"
    }
  ]
}

Commit skills.json to share your skill setup with your team.

Community skills

| Skill | Description | | --- | --- | | context-provider | Official docs URLs for every major framework injected into agent context. Free alternative to Context7. | | frontend-patterns | React and TypeScript component patterns | | frontend-design | Production-grade frontend UI generation | | nextjs-app-router | Next.js App Router — server components, actions, layouts | | nextjs-seo | Metadata API, Open Graph, sitemaps, Core Web Vitals | | tailwind-shadcn | Tailwind CSS and shadcn/ui patterns | | typescript-strict | Strict TypeScript — generics, narrowing, Zod | | react-state-management | Zustand, Redux, TanStack Query decision framework | | react-styled-components | CSS-in-JS with styled-components | | react-redux-toolkit | Redux Toolkit — slices, thunks, RTK Query | | react-chakra-ui | Chakra UI theming, dark mode, forms | | api-design | REST API design — URLs, status codes, pagination | | code-review | Structured code reviews | | security-practices | OWASP security best practices | | git-workflow | Conventional Commits, branching, PR standards | | ui-theme | Apply cohesive visual themes to any artifact | | theme-from-guide | Extract a UI theme from a brand guide | | 3d-frontend | Three.js, WebGL, React Three Fiber | | vector-design | Animated SVGs, GSAP, icon systems | | immersive-storytelling | Scroll-driven narrative web experiences | | cozy-ui | Warm, hygge-inspired interface design | | premium-ui | Luxury, high-end interface design | | airbnb-coding-practices | Airbnb JavaScript and React style guide | | google-coding-practices | Google engineering standards | | meta-coding-practices | Meta React and React Native standards | | microsoft-coding-practices | Microsoft TypeScript and accessibility standards |

Community sets

| Set | What it installs | | --- | --- | | frontend | frontend-design, frontend-patterns, ui-theme | | backend | api-design, code-review, git-workflow | | fullstack | frontend + backend combined | | nextjs-fullstack | nextjs-app-router, nextjs-seo, tailwind-shadcn, typescript-strict, react-state-management | | react-ecosystem | frontend-patterns, typescript-strict, react-state-management, react-styled-components, react-chakra-ui, react-redux-toolkit | | typescript-react | typescript-strict, frontend-patterns, react-state-management | | design-system | tailwind-shadcn, react-chakra-ui, react-styled-components, theme-from-guide | | ai-ready | context-provider, code-review, security-practices | | production-ready | context-provider, code-review, security-practices, git-workflow, api-design, nextjs-seo | | 3d-immersive | 3d-frontend, vector-design, immersive-storytelling | | creative-frontend | frontend-design, cozy-ui, premium-ui, ui-theme, theme-from-guide | | secure-backend | security-practices, api-design, code-review | | google-stack | google-coding-practices, code-review, git-workflow | | meta-stack | meta-coding-practices, code-review, git-workflow | | airbnb-stack | airbnb-coding-practices, frontend-patterns, code-review | | microsoft-stack | microsoft-coding-practices, code-review, git-workflow |

Skills and sets are hosted at github.com/CR-8/ruledrop-community.

Development

npm test
npm run build:client

License

ISC