ai-rulez 3.11.4 → 3.12.0

package/README.md

@@ -1,10 +1,10 @@
 # ai-rulez
 
-Write AI assistant rules once. Generate configs for 18 different tools.
+Directory-based AI governance for 18+ tools. Define rules, context, skills, agents and commands once — generate native configs for Claude, Cursor, Copilot, Windsurf, Gemini, Codex, and more.
 
-Every AI coding tool wants its own config format. Claude needs `CLAUDE.md`, Cursor wants `.cursor/rules/`, Copilot expects `.github/copilot-instructions.md`. Keeping them in sync is tedious and error-prone.
+Every AI coding tool wants its own config format. Claude needs `CLAUDE.md` + `.claude/skills/` + `.claude/agents/`, Cursor wants `.cursor/rules/`, Copilot expects `.github/copilot-instructions.md`. Keeping them in sync is tedious and error-prone.
 
-ai-rulez solves this: define rules and context in `.ai-rulez/`, run `generate`, and get native configs for all your tools.
+ai-rulez solves this: organize your AI governance in `.ai-rulez/`, run `generate`, and get native configs for all your tools — with proper frontmatter, tool-specific formatting, and full feature support (skills, agents, MCP servers).
 
 ```bash
 npx ai-rulez@latest init && npx ai-rulez@latest generate
@@ -153,6 +153,11 @@ ai-rulez add command review-pr
 ai-rulez list rules
 ai-rulez remove rule outdated-rule
 
+# Installed skills
+ai-rulez skill install kreuzberg --source https://github.com/kreuzberg-dev/kreuzberg
+ai-rulez skill list
+ai-rulez skill remove kreuzberg
+
 # Validation
 ai-rulez validate
 
@@ -190,6 +195,26 @@ includes:
 
 Private repos use `AI_RULEZ_GIT_TOKEN` environment variable or `--token` flag.
 
+## Installed Skills
+
+Install named skills from external repositories — fetched dynamically at generate time:
+
+```yaml
+installed_skills:
+  - name: kreuzberg
+    source: https://github.com/kreuzberg-dev/kreuzberg
+  - name: ai-rulez
+    source: https://github.com/Goldziher/ai-rulez
+```
+
+```bash
+ai-rulez skill install kreuzberg --source https://github.com/kreuzberg-dev/kreuzberg
+ai-rulez skill list
+ai-rulez skill remove kreuzberg
+```
+
+Skills live at `skills/<name>/SKILL.md` in the source repo. See [Installed Skills docs](https://goldziher.github.io/ai-rulez/installed-skills/) for details.
+
 ## Generated Output
 
 Running `ai-rulez generate` creates:
@@ -200,9 +225,13 @@ Running `ai-rulez generate` creates:
 | Cursor | `.cursor/rules/*.mdc` |
 | Windsurf | `.windsurf/*.md` |
 | Copilot | `.github/copilot-instructions.md` |
-| Gemini | `.gemini/config.yaml` |
+| Gemini | `GEMINI.md` |
 | Continue.dev | `.continue/prompts/ai_rulez_prompts.yaml` |
 | Cline | `.cline/rules/*.md` |
+| Codex | `AGENTS.md` |
+| Amp | `AMP.md` |
+| Junie | `.junie/guidelines.md` |
+| OpenCode | `OPENCODE.md` |
 | Custom | Any path with markdown, JSON, or directory output |
 
 ## Use Cases

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-rulez",
-  "version": "3.11.4",
-  "description": "⚡ One config to rule them all. Centralized AI assistant configuration management - generate rules for Claude, Cursor, Copilot, Windsurf and more from a single YAML file.",
+  "version": "3.12.0",
+  "description": "Directory-based AI governance for Claude, Cursor, Copilot, Windsurf and 14+ tools. Define rules, context, skills and agents in .ai-rulez/ — generate synchronized configs for all your AI assistants.",
   "keywords": [
     "ai",
     "ai-assistant",