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

# 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

# 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

# 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:

# 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)

# 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

# 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:

# 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

git clone https://github.com/niceguy2k3/namnam-cli.git
cd namnam-cli
npm install

Test Locally

node src/cli.js --help
node src/cli.js list

Publish to npm

# 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:

npm i namnam-skills

Sources

Skills compiled from:

• Anthropic Claude Code Plugins
• Vercel Agent Skills
• ClaudeKit
• BMAD Framework

License

MIT

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