namnam-skills 1.0.0

package/README.md

@@ -0,0 +1,223 @@
+# namnam-skills
+
+> **Universal AI Skills Installer** - One command to rule them all.
+> Supports: Claude, Codex, Cursor, Windsurf, Cline, Aider, Gemini, and more.
+
+## Features
+
+- **150+ Skill Files** from multiple sources
+- **8 AI Platforms** supported with auto-config generation
+- **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
+npx namnam-skills init --all
+
+# Or 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 |
+|----------|-------------|----------------|
+| Claude Code | `.claude/` | ✅ |
+| Cursor | `.cursorrules` | ✅ |
+| Windsurf | `.windsurfrules` | ✅ |
+| Cline | `.clinerules` | ✅ |
+| Aider | `.aider.conf.yml` | ✅ |
+| OpenAI Codex | `codex.md` | ✅ |
+| Google Gemini | `GEMINI.md` | ✅ |
+| Universal | `AGENTS.md` | ✅ |
+
+## Available Categories
+
+| Category | Description | Files |
+|----------|-------------|-------|
+| `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** | 150+ |
+
+## 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
+```
+
+## 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
+├── 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**

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "namnam-skills",
+  "version": "1.0.0",
+  "description": "Ultimate AI Skills Installer - Universal support for Claude, Codex, Cursor, Windsurf, Cline, Aider, and more. 150+ agents, workflows, and skills.",
+  "author": "NamNam",
+  "license": "MIT",
+  "keywords": [
+    "ai",
+    "agents",
+    "skills",
+    "claude",
+    "claude-code",
+    "codex",
+    "openai",
+    "cursor",
+    "windsurf",
+    "cline",
+    "aider",
+    "anthropic",
+    "bmad",
+    "vercel",
+    "claudekit",
+    "cli",
+    "automation",
+    "llm",
+    "coding-assistant",
+    "ai-coding",
+    "developer-tools"
+  ],
+  "type": "module",
+  "bin": {
+    "namnam": "src/cli.js",
+    "namnam-skills": "src/cli.js"
+  },
+  "main": "./src/index.js",
+  "files": [
+    "src/**/*",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node src/cli.js",
+    "test": "node src/cli.js --help",
+    "postinstall": "node src/postinstall.js"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.15",
+    "ora": "^8.0.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/namnam/namnam-skills.git"
+  },
+  "bugs": {
+    "url": "https://github.com/namnam/namnam-skills/issues"
+  },
+  "homepage": "https://github.com/namnam/namnam-skills#readme"
+}