# namnam-skills

> **Universal AI Skills Installer** - One command to rule them all.
> Supports: Claude, Codex, Cursor, Windsurf, Cline, Aider, Gemini, **Antigravity**, and more.

## Features

- **2000+ Skill Files** from multiple sources
- **9 AI Platforms** supported with auto-config generation
- **🚀 Auto Antigravity Integration** - Skills auto-install to `~/.gemini/antigravity/skills/`
- **One Command Install** - `npx namnam-skills init --all`
- **Modular Categories** - Install only what you need
- **Interactive Mode** - Choose categories interactively
- **Universal /namnam** - Orchestrate all agents across platforms

## Quick Start

```bash
# Install all skills + generate platform configs + auto-integrate Antigravity
npm install namnam-skills

# Or use npx for one-time install
npx namnam-skills init --all

# Install interactively
npx namnam-skills init --interactive

# Install specific category
npx namnam-skills init --category vercel

# Just generate platform configs
npx namnam-skills platforms
```

## Supported AI Platforms

| Platform | Config File | Auto-Generated | Auto-Integrated |
|----------|-------------|----------------|-----------------|
| Claude Code | `.claude/` | ✅ | ✅ |
| **Antigravity** | `~/.gemini/antigravity/skills/` | ✅ | ✅ |
| Cursor | `.cursorrules` | ✅ | - |
| Windsurf | `.windsurfrules` | ✅ | - |
| Cline | `.clinerules` | ✅ | - |
| **Roo Code** | `.roo/rules/` | ✅ | - |
| Aider | `.aider.conf.yml` | ✅ | - |
| OpenAI Codex | `codex.md` | ✅ | - |
| Google Gemini | `GEMINI.md` | ✅ | - |
| Universal | `AGENTS.md` | ✅ | - |


## Available Categories

| Category | Description | Files |
|----------|-------------|-------|
| `antigravity_skills` | 240+ skill categories (web, security, DB, AI...) | 1900+ |
| `core` | /namnam, git, code-review, validate-and-fix | 6 |
| `platforms` | Config templates for all AI platforms | 7 |
| `official_plugins` | Anthropic: feature-dev, commit, PR review, hookify, security, ralph-loop | 11 |
| `vercel` | React best practices (51 rules), web design | 2 |
| `claudekit` | Oracle, triage, research, checkpoints | 13 |
| `cursor_rules` | Expert rules: TypeScript, Python, React Native, Vue, Go, Rust, DevOps | 10 |
| `system_prompts` | Industry best practices from 30+ AI tools (Claude, Cursor, Windsurf, Cline, Antigravity) | 6 |
| `bmad_bmm` | Business Method: PRD, architecture, sprints | 40+ |
| `bmad_bmgd` | Game Dev: GDD, game architecture | 30+ |
| `bmad_cis` | Creative: brainstorming, design thinking | 10+ |
| `bmad_bmb` | Builder: agent, module, workflow builders | 6 |
| `bmad_core` | BMAD Core: master agent, party mode | 5 |
| `all` | **Everything** | 2000+ |

## Commands

### Install Skills

```bash
# Install all
npx namnam-skills init --all

# Interactive mode
npx namnam-skills init --interactive

# Specific category
npx namnam-skills init --category claudekit

# Force overwrite
npx namnam-skills init --all --force

# With platform configs
npx namnam-skills init --platforms
```

### Other Commands

```bash
# List categories and platforms
npx namnam-skills list

# Check installed skills
npx namnam-skills info

# Generate platform configs only
npx namnam-skills platforms

# Remove all skills
npx namnam-skills uninstall
```

### 🧠 Semantic Commands (Augment-like Features!)

The semantic layer provides LLM-powered codebase understanding through embeddings and RAG:

```bash
# Build semantic index with code embeddings
namnam semantic index
namnam sem index --force                    # Re-index everything
namnam sem index --provider openai          # Use OpenAI embeddings

# Semantic search - find code by meaning, not just text
namnam sem search "authentication logic"
namnam sem search "how to handle errors" --top 5

# Ask questions about your codebase (RAG)
namnam sem ask "how does the login flow work?"
namnam sem ask "what design patterns are used?" --provider openai

# Find similar code
namnam sem similar src/auth.js
namnam sem similar components/Button.tsx --top 10

# Generate context for AI tasks
namnam sem context "implement logout feature"

# View index statistics
namnam sem stats

# Configure providers
namnam sem config --show
namnam sem config --embedding-provider openai --embedding-model text-embedding-3-small
namnam sem config --llm-provider anthropic --llm-model claude-3-sonnet-20240229

# Clear index
namnam sem clear
```

#### Supported Providers

| Type | Provider | Models | Notes |
|------|----------|--------|-------|
| **Embeddings** | `ollama` | nomic-embed-text, all-minilm | 🆓 Local, no API key |
| | `openai` | text-embedding-3-small/large | ☁️ Cloud, fast |
| | `voyage` | voyage-code-2 | 🎯 Code-optimized |
| **LLM** | `ollama` | codellama, llama2, mistral | 🆓 Local, no API key |
| | `openai` | gpt-4o, gpt-4-turbo | ☁️ Best quality |
| | `anthropic` | claude-3-sonnet, claude-3-opus | ☁️ Best for code |

#### Quick Setup (Zero Cost with Ollama)

```bash
# 1. Install Ollama (https://ollama.ai)
# 2. Pull embedding model
ollama pull nomic-embed-text

# 3. Pull LLM model  
ollama pull codellama

# 4. Build index
namnam sem index

# 5. Start asking questions!
namnam sem ask "explain the main architecture"
```

#### 🤖 Auto Mode (Like Augment AI!)

**Zero configuration needed!** When you install namnam-skills, it automatically:
1. Indexes your codebase with embeddings
2. Watches for file changes  
3. Provides context for AI prompts

```bash
# Check auto mode status
namnam sem auto

# Enable full auto mode
namnam sem auto --enable

# Start real-time file watcher
namnam sem watch

# Generate context for current task
namnam sem auto-context -q "implement logout" -f src/auth.js

# Integrate with Claude Code
namnam sem integrate
```

**How it works:**
- On `npm install` → Auto-indexes codebase
- On file changes → Updates vectors automatically
- On AI prompt → Context is available via `namnam sem auto-context`


## The `/namnam` Command

After installation, use the powerful `/namnam` universal orchestrator:

```bash
# Auto-select agents based on task
/namnam review and optimize this codebase

# Maximum power mode
/namnam --full implement user authentication

# Quick mode
/namnam --quick fix the login bug

# Specific modes
/namnam --review         # Code review focus
/namnam --build          # Development focus
/namnam --test           # Testing focus
/namnam --security       # Security audit
/namnam --performance    # Performance optimization
/namnam --game           # Game dev agents
/namnam --creative       # Innovation agents
/namnam --multi-platform # Sync all AI configs
```

## Included Skills

### Core Skills
- `/namnam` - Universal orchestrator (works across all AI platforms)
- `/git:commit`, `/git:push`, `/git:status` - Git operations
- `/code-review` - Multi-aspect code review
- `/validate-and-fix` - Run checks and auto-fix

### Official Anthropic Plugins
- `/feature-dev` - 7-phase structured development
- `/commit`, `/commit-push-pr` - Smart commits
- `/pr-review-toolkit:review-pr` - PR review suite
- `/new-sdk-app` - Agent SDK bootstrapper

### Vercel Skills
- `/react-best-practices` - 51 React/Next.js performance rules
- `/web-design-guidelines` - UI/UX audit

### ClaudeKit
- `/oracle` - Deep debugging, security audits
- `/triage-expert` - Problem diagnosis
- `/research-expert` - Parallel research
- `/code-search` - Codebase search
- `/checkpoint:create`, `/checkpoint:restore` - Checkpoints
- `/create-subagent`, `/create-command` - Extensibility

### BMAD Framework
- **BMM**: PRD, architecture, epics, stories, sprints
- **BMGD**: Game design documents, playtesting
- **CIS**: Brainstorming, design thinking, storytelling
- **BMB**: Agent/module/workflow builders

## Platform Config Generation

Run `npx namnam-skills platforms` to auto-generate:

```
your-project/
├── AGENTS.md           # Universal (all platforms read this)
├── .cursorrules        # For Cursor AI
├── .windsurfrules      # For Windsurf
├── .clinerules         # For Cline
├── .roo/rules/         # For Roo Code (5 rule files)
├── codex.md            # For OpenAI Codex
├── GEMINI.md           # For Google Gemini
└── .aider.conf.yml     # For Aider
```

## Requirements

- Node.js 18+
- Any supported AI coding assistant

## Development & Publishing

### Clone and Install
```bash
git clone https://github.com/niceguy2k3/namnam-cli.git
cd namnam-cli
npm install
```

### Test Locally
```bash
node src/cli.js --help
node src/cli.js list
```

### Publish to npm
```bash
# Login to npm (if not already)
npm login

# Publish (requires npm account with 2FA)
npm publish --access public

# Or with OTP
npm publish --access public --otp=XXXXXX
```

### After Publishing
Users can install with:
```bash
npm i namnam-skills
```

## Sources

Skills compiled from:
- [Anthropic Claude Code Plugins](https://github.com/anthropics/claude-code/tree/main/plugins)
- [Vercel Agent Skills](https://github.com/vercel-labs/agent-skills)
- [ClaudeKit](https://github.com/carlrannaberg/claudekit)
- [BMAD Framework](https://github.com/bmadcode/bmad-agent)

## License

MIT

---

**Created with ❤️ by NamNam - Universal AI Power for Maximum Productivity**