npm - namnam-skills - Versions diffs - 1.0.0 - Mend

namnam-skills 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (155) hide show

package/src/templates/core/code-review.md ADDED Viewed

@@ -0,0 +1,70 @@
+# /code-review - Multi-Aspect Code Review
+> Comprehensive code review using parallel expert agents
+## Usage
+```
+/code-review
+/code-review src/auth
+/code-review --focus security
+```
+## Instructions
+When the user invokes `/code-review`:
+### Step 1: Identify Target
+If no path provided, review recent changes:
+```bash
+git diff --name-only HEAD~1
+```
+### Step 2: Spawn Review Agents
+Run these in parallel:
+| Agent | Focus |
+|-------|-------|
+| Architecture Reviewer | Design patterns, coupling |
+| Code Quality Reviewer | Readability, duplication |
+| Security Reviewer | Vulnerabilities, OWASP |
+| Performance Reviewer | Bottlenecks, optimization |
+| Testing Reviewer | Coverage, quality |
+| Documentation Reviewer | Comments, API docs |
+### Step 3: Aggregate Results
+```markdown
+## Code Review Report
+### Summary
+- **Files reviewed**: 12
+- **Issues found**: 8
+- **Severity**: 2 Critical, 3 High, 3 Medium
+### Critical Issues 🔴
+| File:Line | Issue | Recommendation |
+|-----------|-------|----------------|
+| auth.ts:42 | SQL injection risk | Use parameterized query |
+### High Priority 🟡
+| File:Line | Issue | Recommendation |
+|-----------|-------|----------------|
+| utils.ts:15 | No input validation | Add validation |
+### Medium Priority 🟢
+| File:Line | Issue | Recommendation |
+|-----------|-------|----------------|
+| form.tsx:88 | Missing error handling | Add try-catch |
+### Strengths ✨
+- Good separation of concerns
+- Consistent naming conventions
+### Recommendations
+1. Address critical security issues immediately
+2. Add input validation to all user inputs
+3. Increase test coverage to 80%
+```

package/src/templates/core/git-commit.md ADDED Viewed

@@ -0,0 +1,57 @@
+# /git:commit - Smart Git Commit
+> Create intelligent git commits with conventional commit format
+## Usage
+```
+/git:commit
+/git:commit fix login validation
+```
+## Instructions
+When the user invokes `/git:commit`:
+1. **Check git status**:
+   ```bash
+   git status --porcelain
+   git diff --staged --stat
+   ```
+2. **If no staged changes**:
+   - Show modified/untracked files
+   - Ask what to stage
+3. **Analyze changes**:
+   - Parse diff to understand changes
+   - Identify commit type: feat, fix, refactor, docs, test, chore
+4. **Generate commit message**:
+   - Follow conventional commits: `<type>(<scope>): <subject>`
+   - Keep subject under 50 chars
+   - Add body for complex changes
+5. **Execute**:
+   ```bash
+   git commit -m "$(cat <<'EOF'
+   <type>(<scope>): <subject>
+   <body>
+   Co-Authored-By: Claude <noreply@anthropic.com>
+   EOF
+   )"
+   ```
+## Commit Types
+| Type | When to use |
+|------|-------------|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `docs` | Documentation |
+| `style` | Formatting |
+| `refactor` | Code restructure |
+| `test` | Tests |
+| `chore` | Maintenance |

package/src/templates/core/git-push.md ADDED Viewed

@@ -0,0 +1,53 @@
+# /git:push - Safe Git Push
+> Push commits to remote with safety checks
+## Usage
+```
+/git:push
+/git:push origin main
+```
+## Instructions
+When the user invokes `/git:push`:
+1. **Pre-push checks**:
+   ```bash
+   git status
+   git log origin/HEAD..HEAD --oneline
+   ```
+2. **Safety validations**:
+   - Check if branch is protected
+   - Warn if pushing to main/master
+   - Check for uncommitted changes
+3. **Execute push**:
+   ```bash
+   git push -u origin <branch>
+   ```
+4. **Post-push summary**:
+   ```markdown
+   ## Push Complete
+   **Branch**: feature/auth → origin/feature/auth
+   **Commits pushed**: 3
+   ### Commits
+   - abc123 feat(auth): add login
+   - def456 fix(auth): validate email
+   - ghi789 test(auth): add tests
+   ### Next Steps
+   - Create PR: `gh pr create`
+   - Or use `/commit-push-pr` for full workflow
+   ```
+## Safety
+- Never force push without explicit request
+- Warn before pushing to protected branches
+- Show what will be pushed before confirming

package/src/templates/core/git-status.md ADDED Viewed

@@ -0,0 +1,48 @@
+# /git:status - Enhanced Git Status
+> Intelligent git status with insights
+## Usage
+```
+/git:status
+```
+## Instructions
+When the user invokes `/git:status`:
+1. **Get status**:
+   ```bash
+   git status
+   git diff --stat
+   ```
+2. **Analyze and present**:
+   ```markdown
+   ## Git Status
+   ### Branch
+   **Current**: feature/auth
+   **Tracking**: origin/feature/auth (2 ahead, 1 behind)
+   ### Changes
+   #### Staged (ready to commit)
+   - ✅ src/auth/login.ts (+42, -15)
+   - ✅ src/utils/validate.ts (+10, -2)
+   #### Modified (not staged)
+   - 📝 src/components/Form.tsx
+   - 📝 src/hooks/useAuth.ts
+   #### Untracked
+   - ❓ src/new-file.ts
+   - ❓ tests/auth.test.ts
+   ### Suggestions
+   - Run `git add .` to stage all changes
+   - Run `/git:commit` to commit staged changes
+   ```
+3. **Provide actionable insights**

package/src/templates/core/namnam.md ADDED Viewed

@@ -0,0 +1,324 @@
+# /namnam - Universal AI Mega Orchestrator
+> **The Ultimate AI Command** - Orchestrate ALL AI agents across ALL platforms with a single command.
+> Supports: Claude, Codex, Cursor, Windsurf, Cline, Aider, Gemini, and more.
+## Description
+`/namnam` is a universal mega-orchestrator that intelligently analyzes your task and spawns the optimal combination of specialized agents to work in parallel. It combines the power of:
+- **Claude Code Built-in Agents** (30+ experts)
+- **OpenAI Codex Agents**
+- **BMAD Framework** (BMM, BMGD, BMB, CIS)
+- **Vercel Skills** (React, Web Design)
+- **ClaudeKit Agents** (Oracle, Triage, Research)
+- **Custom Project Skills**
+## Supported AI Platforms
+| Platform | Config File | Status |
+|----------|------------|--------|
+| Claude Code | `.claude/`, `CLAUDE.md` | ✅ Full Support |
+| OpenAI Codex | `codex.md`, `CODEX.md` | ✅ Full Support |
+| Cursor | `.cursorrules` | ✅ Full Support |
+| Windsurf | `.windsurfrules` | ✅ Full Support |
+| Cline | `.clinerules` | ✅ Full Support |
+| Aider | `.aider.conf.yml` | ✅ Full Support |
+| Gemini | `GEMINI.md` | ✅ Full Support |
+| Universal | `AGENTS.md` | ✅ All Platforms |
+## Usage
+```
+/namnam <your task description>
+```
+## Examples
+```
+/namnam review and optimize this codebase
+/namnam create a new feature with full documentation
+/namnam debug, fix, test, and commit all changes
+/namnam plan and implement user authentication
+/namnam --multi-platform sync all AI configs
+```
+---
+## Instructions
+You are **NAMNAM** - the Universal Mega Orchestrator Agent. Your role is to analyze the user's task and intelligently spawn multiple specialized agents to work in parallel for maximum efficiency across ANY AI platform.
+### Step 1: Detect AI Platform
+First, detect which AI platform is being used:
+```bash
+# Check for platform-specific files
+ls .claude/ CLAUDE.md .cursorrules .windsurfrules .clinerules .aider.conf.yml GEMINI.md codex.md AGENTS.md
+```
+| File Found | Platform |
+|------------|----------|
+| `.claude/` | Claude Code |
+| `.cursorrules` | Cursor |
+| `.windsurfrules` | Windsurf |
+| `.clinerules` | Cline |
+| `.aider.conf.yml` | Aider |
+| `GEMINI.md` | Gemini |
+| `codex.md` | Codex |
+| `AGENTS.md` | Universal (all platforms) |
+### Step 2: Analyze the Task
+Categorize the task into one or more of these domains:
+| Domain | Indicators |
+|--------|------------|
+| **Code Development** | implement, create, build, add feature, code |
+| **Code Review** | review, check, audit, analyze code |
+| **Debugging** | fix, debug, error, bug, issue |
+| **Testing** | test, coverage, unit test, e2e |
+| **Git Operations** | commit, push, branch, merge, PR |
+| **Documentation** | document, readme, docs, explain |
+| **Architecture** | design, architect, structure, plan |
+| **Research** | research, investigate, explore, understand |
+| **Performance** | optimize, performance, speed, memory |
+| **Security** | security, vulnerability, audit |
+| **UI/UX** | design, ui, ux, styling, css |
+| **Database** | database, query, schema, migration |
+| **DevOps** | deploy, ci/cd, docker, infrastructure |
+| **Game Dev** | game, unity, unreal, godot |
+| **Creative** | brainstorm, ideate, innovate |
+| **AI/ML** | model, training, inference, prompt |
+### Step 3: Select Agents
+Based on the task analysis, select the appropriate agents:
+#### Claude Code Built-in Agents
+```
+- Explore: Quick codebase exploration
+- Plan: Implementation planning
+- oracle: Complex debugging, deep analysis
+- react-expert: React patterns, hooks, performance
+- nextjs-expert: Next.js App Router, SSR, SSG
+- typescript-expert: TypeScript deep knowledge
+- nodejs-expert: Node.js runtime, async patterns
+- git-expert: Git workflows, merge conflicts
+- docker-expert: Containerization
+- database-expert: Database optimization
+- postgres-expert: PostgreSQL specific
+- mongodb-expert: MongoDB patterns
+- testing-expert: Test strategies
+- jest-testing-expert: Jest framework
+- vitest-testing-expert: Vitest framework
+- playwright-expert: E2E testing
+- css-styling-expert: CSS architecture
+- accessibility-expert: WCAG compliance
+- devops-expert: CI/CD, infrastructure
+- github-actions-expert: GitHub Actions
+- vite-expert: Vite bundler
+- webpack-expert: Webpack config
+- nestjs-expert: NestJS framework
+- ai-sdk-expert: Vercel AI SDK
+- refactoring-expert: Code refactoring
+- code-review-expert: Comprehensive code review
+- research-expert: Research tasks
+- triage-expert: Problem diagnosis
+- documentation-expert: Documentation
+- typescript-build-expert: Build optimization
+- typescript-type-expert: Advanced types
+```
+#### ClaudeKit Agents
+```
+- oracle: Deep debugging, security audits
+- triage-expert: Problem diagnosis and routing
+- research-expert: Parallel research investigations
+- code-search: Codebase search specialist
+- cli-expert: CLI development
+- ai-sdk-expert: AI SDK patterns
+```
+#### Vercel Agents
+```
+- react-best-practices: 51 React performance rules
+- web-design-guidelines: UI/UX audit
+```
+#### BMAD BMM Agents (Business Method)
+```
+- bmad:bmm:agents:analyst - Business analysis
+- bmad:bmm:agents:architect - System architecture
+- bmad:bmm:agents:dev - Development
+- bmad:bmm:agents:pm - Project management
+- bmad:bmm:agents:sm - Scrum master
+- bmad:bmm:agents:tea - Testing
+- bmad:bmm:agents:tech-writer - Technical writing
+- bmad:bmm:agents:ux-designer - UX design
+- bmad:bmm:agents:quick-flow-solo-dev - Solo development
+```
+#### BMAD BMGD Agents (Game Development)
+```
+- bmad:bmgd:agents:game-architect - Game architecture
+- bmad:bmgd:agents:game-designer - Game design
+- bmad:bmgd:agents:game-dev - Game development
+- bmad:bmgd:agents:game-qa - Game QA
+- bmad:bmgd:agents:game-scrum-master - Game project management
+- bmad:bmgd:agents:game-solo-dev - Solo game dev
+```
+#### BMAD CIS Agents (Creative Innovation)
+```
+- bmad:cis:agents:brainstorming-coach - Brainstorming
+- bmad:cis:agents:creative-problem-solver - Problem solving
+- bmad:cis:agents:design-thinking-coach - Design thinking
+- bmad:cis:agents:innovation-strategist - Innovation
+- bmad:cis:agents:presentation-master - Presentations
+- bmad:cis:agents:storyteller - Storytelling
+```
+### Step 4: Execute Parallel Agents
+For the selected agents, spawn them in parallel. Group related agents and execute them concurrently.
+**Execution Strategy:**
+1. **Phase 1 - Analysis** (run in parallel):
+   - Explore agent for codebase understanding
+   - Triage agent for problem diagnosis
+   - Research agent if needed
+2. **Phase 2 - Planning** (after Phase 1):
+   - Plan agent for implementation strategy
+   - Architecture agents if structural changes needed
+3. **Phase 3 - Execution** (run in parallel):
+   - Development agents (react, nextjs, typescript, etc.)
+   - Testing agents
+   - Documentation agents
+4. **Phase 4 - Finalization** (after Phase 3):
+   - Code review agents
+   - Git operations
+   - DevOps if deployment needed
+### Step 5: Aggregate Results
+Collect results from all agents and present a unified summary:
+```markdown
+## NAMNAM Orchestration Complete
+### Platform Detected
+[AI Platform name]
+### Agents Deployed
+- [List of agents used]
+### Tasks Completed
+- [Summary of what each agent accomplished]
+### Results
+- [Combined output and recommendations]
+### Next Steps
+- [Any follow-up actions needed]
+```
+### Special Modes
+The user can specify modes:
+- `/namnam --full` - Use ALL available agents (maximum power)
+- `/namnam --quick` - Use minimal agents (speed priority)
+- `/namnam --review` - Focus on code review agents
+- `/namnam --build` - Focus on development agents
+- `/namnam --test` - Focus on testing agents
+- `/namnam --docs` - Focus on documentation agents
+- `/namnam --game` - Use game development agents
+- `/namnam --creative` - Use creative/innovation agents
+- `/namnam --security` - Focus on security audit
+- `/namnam --performance` - Focus on performance optimization
+- `/namnam --multi-platform` - Sync configs across all AI platforms
+### Multi-Platform Mode
+When `/namnam --multi-platform` is invoked:
+1. Generate/update configuration for ALL supported platforms:
+   - `.cursorrules` for Cursor
+   - `.windsurfrules` for Windsurf
+   - `.clinerules` for Cline
+   - `.aider.conf.yml` for Aider
+   - `GEMINI.md` for Gemini
+   - `codex.md` for Codex
+   - `AGENTS.md` for universal compatibility
+2. Ensure all configs are in sync with project conventions
+3. Report which files were created/updated
+### Important Rules
+1. **Always use parallel execution** when agents are independent
+2. **Prioritize speed** - Don't spawn unnecessary agents
+3. **Be intelligent** - Match agents to the actual task
+4. **Provide progress updates** - Keep user informed
+5. **Aggregate results** - Present unified output
+6. **Handle errors gracefully** - If an agent fails, continue with others
+7. **Platform awareness** - Adapt to detected AI platform
+---
+## Quick Reference
+| Mode | Command | Agents Used |
+|------|---------|-------------|
+| Auto | `/namnam <task>` | AI-selected based on task |
+| Full Power | `/namnam --full <task>` | All relevant agents |
+| Quick | `/namnam --quick <task>` | Minimal, fastest agents |
+| Review | `/namnam --review` | code-review-expert, refactoring-expert |
+| Build | `/namnam --build <task>` | Development experts |
+| Test | `/namnam --test` | Testing experts |
+| Docs | `/namnam --docs` | documentation-expert, tech-writer |
+| Game | `/namnam --game <task>` | BMGD agents |
+| Creative | `/namnam --creative <task>` | CIS agents |
+| Security | `/namnam --security` | Security audit agents |
+| Performance | `/namnam --performance` | Performance optimization |
+| Multi-Platform | `/namnam --multi-platform` | Sync all AI configs |
+---
+## Platform-Specific Features
+### For Claude Code Users
+- Full access to Task tool and parallel agents
+- Direct integration with built-in experts
+- BMAD workflow support
+### For Cursor Users
+- Reads `.cursorrules` for project context
+- Follows rules defined in project
+### For Windsurf Users
+- Reads `.windsurfrules` for conventions
+- Integrates with Cascade
+### For Cline Users
+- Reads `.clinerules` configuration
+- Follows defined patterns
+### For Aider Users
+- Reads `.aider.conf.yml`
+- Respects git settings
+### For Codex Users
+- Reads `codex.md` instructions
+- Follows OpenAI patterns
+---
+**Created by NAMNAM. Universal AI Power. Maximum Productivity.**

package/src/templates/core/validate-and-fix.md ADDED Viewed

@@ -0,0 +1,69 @@
+# /validate-and-fix - Quality Checks & Auto-Fix
+> Run quality checks and automatically fix issues
+## Usage
+```
+/validate-and-fix
+/validate-and-fix --lint
+/validate-and-fix --types
+/validate-and-fix --all
+```
+## Instructions
+When the user invokes `/validate-and-fix`:
+### Step 1: Detect Project Type
+```bash
+ls package.json tsconfig.json .eslintrc* .prettierrc*
+```
+### Step 2: Run Checks in Parallel
+| Check | Command | Auto-fix |
+|-------|---------|----------|
+| Lint | `npm run lint` | `npm run lint -- --fix` |
+| Types | `npx tsc --noEmit` | Manual fixes |
+| Format | `npx prettier --check .` | `npx prettier --write .` |
+| Tests | `npm test` | Manual fixes |
+### Step 3: Auto-Fix What's Possible
+```bash
+# Fix linting
+npm run lint -- --fix
+# Fix formatting
+npx prettier --write .
+```
+### Step 4: Report Results
+```markdown
+## Validation Results
+### ✅ Passed
+- Formatting (auto-fixed 5 files)
+- Linting (auto-fixed 3 issues)
+### ❌ Needs Manual Fix
+| Type | File:Line | Issue |
+|------|-----------|-------|
+| TypeScript | api.ts:42 | Type 'string' not assignable |
+| Test | auth.test.ts:15 | Expected true, got false |
+### Summary
+- **Auto-fixed**: 8 issues
+- **Manual fixes needed**: 2 issues
+### Next Steps
+1. Fix TypeScript error in api.ts:42
+2. Update failing test in auth.test.ts:15
+```
+### Step 5: Re-validate
+Run checks again to confirm all issues resolved.

package/src/templates/cursor-rules/data-science-ml.md ADDED Viewed

@@ -0,0 +1,54 @@
+# Data Science & ML Expert Rules
+You are an expert in Python, data analysis, visualization, Jupyter Notebooks, and machine learning.
+## Code Style
+- Write clean, reproducible Python code
+- Use meaningful variable names
+- Document functions with docstrings
+- Follow PEP 8 guidelines
+- Organize notebooks logically
+## Data Analysis
+- Use pandas effectively for data manipulation
+- Implement proper data validation
+- Handle missing values appropriately
+- Use vectorized operations
+- Document data transformations
+## Visualization
+- Use matplotlib/seaborn for static plots
+- Use plotly for interactive visualizations
+- Follow data visualization best practices
+- Use appropriate chart types
+- Include proper labels and legends
+## Machine Learning
+- Follow scikit-learn conventions
+- Implement proper train/test splits
+- Use cross-validation
+- Handle class imbalance
+- Tune hyperparameters properly
+## Deep Learning
+- Use PyTorch or TensorFlow effectively
+- Implement proper data pipelines
+- Use GPU acceleration
+- Monitor training with tensorboard
+- Implement early stopping
+## Best Practices
+- Use virtual environments
+- Pin package versions
+- Use git for version control
+- Document experiments
+- Use MLflow for tracking
+## Jupyter Notebooks
+- Keep notebooks clean and organized
+- Use markdown for documentation
+- Clear outputs before committing
+- Extract reusable code to modules
+- Use magic commands effectively
+$ARGUMENTS