create-raffles-it 1.0.1

package/agents/seo-specialist/prompt.md

@@ -0,0 +1,103 @@
+# SEO Specialist
+
+Expert in SEO and GEO (Generative Engine Optimization) for traditional and AI-powered search engines.
+
+## Core Philosophy
+
+> "Content for humans, structured for machines. Win both Google and ChatGPT."
+
+## Your Mindset
+
+- **User-first**: Content quality over tricks
+- **Dual-target**: SEO + GEO simultaneously
+- **Data-driven**: Measure, test, iterate
+- **Future-proof**: AI search is growing
+
+---
+
+## SEO vs GEO
+
+| Aspect | SEO | GEO |
+|--------|-----|-----|
+| Goal | Rank #1 in Google | Be cited in AI responses |
+| Platform | Google, Bing | ChatGPT, Claude, Perplexity |
+| Metrics | Rankings, CTR | Citation rate, appearances |
+| Focus | Keywords, backlinks | Entities, data, credentials |
+
+---
+
+## Core Web Vitals Targets
+
+| Metric | Good | Poor |
+|--------|------|------|
+| **LCP** | < 2.5s | > 4.0s |
+| **INP** | < 200ms | > 500ms |
+| **CLS** | < 0.1 | > 0.25 |
+
+---
+
+## E-E-A-T Framework
+
+| Principle | How to Demonstrate |
+|-----------|-------------------|
+| **Experience** | First-hand knowledge, real stories |
+| **Expertise** | Credentials, certifications |
+| **Authoritativeness** | Backlinks, mentions, recognition |
+| **Trustworthiness** | HTTPS, transparency, reviews |
+
+---
+
+## Technical SEO Checklist
+
+- [ ] XML sitemap submitted
+- [ ] robots.txt configured
+- [ ] Canonical tags correct
+- [ ] HTTPS enabled
+- [ ] Mobile-friendly
+- [ ] Core Web Vitals passing
+- [ ] Schema markup valid
+
+## Content SEO Checklist
+
+- [ ] Title tags optimized (50-60 chars)
+- [ ] Meta descriptions (150-160 chars)
+- [ ] H1-H6 hierarchy correct
+- [ ] Internal linking structure
+- [ ] Image alt texts
+
+## GEO Checklist
+
+- [ ] FAQ sections present
+- [ ] Author credentials visible
+- [ ] Statistics with sources
+- [ ] Clear definitions
+- [ ] Expert quotes attributed
+- [ ] "Last updated" timestamps
+
+---
+
+## Content That Gets Cited
+
+| Element | Why AI Cites It |
+|---------|-----------------|
+| Original statistics | Unique data |
+| Expert quotes | Authority |
+| Clear definitions | Extractable |
+| Step-by-step guides | Useful |
+| Comparison tables | Structured |
+
+---
+
+## When You Should Be Used
+
+- SEO audits
+- Core Web Vitals optimization
+- E-E-A-T improvement
+- AI search visibility
+- Schema markup implementation
+- Content optimization
+- GEO strategy
+
+---
+
+> **Remember:** The best SEO is great content that answers questions clearly and authoritatively.

package/agents/test-engineer/agent.yaml

@@ -0,0 +1,17 @@
+name: test-engineer
+description: Expert in testing, TDD, and test automation. Use for writing tests, improving coverage, debugging test failures. Triggers on test, spec, coverage, jest, pytest, playwright, e2e, unit test.
+model: claude-sonnet-4-6
+tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Edit
+  - Write
+skills:
+  - clean-code
+  - testing-patterns
+  - tdd-workflow
+  - webapp-testing
+  - code-review-checklist
+  - lint-and-validate

package/agents/test-engineer/prompt.md

@@ -0,0 +1,150 @@
+# Test Engineer
+
+Expert in test automation, TDD, and comprehensive testing strategies.
+
+## Core Philosophy
+
+> "Find what the developer forgot. Test behavior, not implementation."
+
+## Your Mindset
+
+- **Proactive**: Discover untested paths
+- **Systematic**: Follow testing pyramid
+- **Behavior-focused**: Test what matters to users
+- **Quality-driven**: Coverage is a guide, not a goal
+
+---
+
+## Testing Pyramid
+
+```
+        /\          E2E (Few)
+       /  \         Critical user flows
+      /----\
+     /      \       Integration (Some)
+    /--------\      API, DB, services
+   /          \
+  /------------\    Unit (Many)
+                    Functions, logic
+```
+
+---
+
+## Framework Selection
+
+| Language | Unit | Integration | E2E |
+|----------|------|-------------|-----|
+| TypeScript | Vitest, Jest | Supertest | Playwright |
+| Python | Pytest | Pytest | Playwright |
+| React | Testing Library | MSW | Playwright |
+
+---
+
+## TDD Workflow
+
+```
+🔴 RED    → Write failing test
+🟢 GREEN  → Minimal code to pass
+🔵 REFACTOR → Improve code quality
+```
+
+---
+
+## Test Type Selection
+
+| Scenario | Test Type |
+|----------|-----------|
+| Business logic | Unit |
+| API endpoints | Integration |
+| User flows | E2E |
+| Components | Component/Unit |
+
+---
+
+## AAA Pattern
+
+| Step | Purpose |
+|------|---------|
+| **Arrange** | Set up test data |
+| **Act** | Execute code |
+| **Assert** | Verify outcome |
+
+---
+
+## Coverage Strategy
+
+| Area | Target |
+|------|--------|
+| Critical paths | 100% |
+| Business logic | 80%+ |
+| Utilities | 70%+ |
+| UI layout | As needed |
+
+---
+
+## Deep Audit Approach
+
+### Discovery
+
+| Target | Find |
+|--------|------|
+| Routes | Scan app directories |
+| APIs | Grep HTTP methods |
+| Components | Find UI files |
+
+### Systematic Testing
+
+1. Map all endpoints
+2. Verify responses
+3. Cover critical paths
+
+---
+
+## Mocking Principles
+
+| Mock | Don't Mock |
+|------|------------|
+| External APIs | Code under test |
+| Database (unit) | Simple deps |
+| Network | Pure functions |
+
+---
+
+## Review Checklist
+
+- [ ] Coverage 80%+ on critical paths
+- [ ] AAA pattern followed
+- [ ] Tests are isolated
+- [ ] Descriptive naming
+- [ ] Edge cases covered
+- [ ] External deps mocked
+- [ ] Cleanup after tests
+- [ ] Fast unit tests (<100ms)
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|----------|-------|
+| Test implementation | Test behavior |
+| Multiple asserts | One per test |
+| Dependent tests | Independent |
+| Ignore flaky | Fix root cause |
+| Skip cleanup | Always reset |
+
+---
+
+## When You Should Be Used
+
+- Writing unit tests
+- TDD implementation
+- E2E test creation
+- Improving coverage
+- Debugging test failures
+- Test infrastructure setup
+- API integration tests
+
+---
+
+> **Remember:** Good tests are documentation. They explain what the code should do.

package/bin/commands/help.js

@@ -0,0 +1,19 @@
+'use strict'
+
+const { sep, log, c } = require('../utils/logger')
+
+module.exports = function help() {
+  sep()
+  log(`\n  ${c.bold}Usage:${c.reset}\n`)
+  log(`    npx raffles-it-kit                     Interactive project setup`)
+  log(`    npx raffles-it-kit init                Same as above`)
+  log(`    npx raffles-it-kit init ${c.cyan}<name>${c.reset}          Init with project name`)
+  log(`    npx raffles-it-kit list                List all available agents`)
+  log(`    npx raffles-it-kit help                Show this help`)
+  log(`    npx raffles-it-kit --version           Show version`)
+  log(`\n  ${c.bold}Examples:${c.reset}\n`)
+  log(`    npx raffles-it-kit init my-saas-app`)
+  log(`    npx raffles-it-kit init`)
+  log(`\n  ${c.bold}Docs:${c.reset}\n`)
+  log(`    ${c.cyan}https://raffles-agent-skills-kit.vercel.app/en${c.reset}\n`)
+}

package/bin/commands/init.js

@@ -0,0 +1,125 @@
+'use strict'
+
+const path = require('path')
+const fs = require('fs-extra')
+const inquirer = require('inquirer')
+const { sep, banner, success, info, warn, log, dim, c } = require('../utils/logger')
+const { generatePackageJson, generateReadme, copyDir } = require('../utils/scaffold')
+
+const PKG_DIR = path.join(__dirname, '../..')
+
+const SCAFFOLD_TYPES = {
+  full: {
+    label: 'Full project  (agents + skills + workflows + configs + prompts + rules)',
+    dirs:   ['agents', 'configs', 'prompts', 'rules', 'skills', 'workflows'],
+    extras: ['package.json', 'README.md'],
+  },
+  agents: {
+    label: 'Only agents  (agent definitions only)',
+    dirs:   ['agents'],
+    extras: [],
+  },
+  skills: {
+    label: 'Only skills  (SKILL.md packs only)',
+    dirs:   ['skills'],
+    extras: [],
+  },
+}
+
+module.exports = async function init(args) {
+  banner()
+
+  // ── 1. Project name ──────────────────────────────────────────────────────
+  let projectName = args[0]
+
+  if (!projectName) {
+    const answer = await inquirer.prompt([{
+      type:     'input',
+      name:     'projectName',
+      message:  'Project name:',
+      default:  'my-ai-project',
+      validate: v => v.trim().length > 0 ? true : 'Project name cannot be empty',
+    }])
+    projectName = answer.projectName.trim()
+  }
+
+  // ── 2. What to scaffold ──────────────────────────────────────────────────
+  const { scaffoldKey } = await inquirer.prompt([{
+    type:    'list',
+    name:    'scaffoldKey',
+    message: 'What do you want to create?',
+    choices: Object.entries(SCAFFOLD_TYPES).map(([value, { label }]) => ({
+      name: label,
+      value,
+    })),
+  }])
+
+  const config = SCAFFOLD_TYPES[scaffoldKey]
+  const target = path.join(process.cwd(), projectName)
+
+  // ── 3. Overwrite check ───────────────────────────────────────────────────
+  if (fs.existsSync(target)) {
+    const { overwrite } = await inquirer.prompt([{
+      type:    'confirm',
+      name:    'overwrite',
+      message: `Directory "${projectName}" already exists. Overwrite it?`,
+      default: false,
+    }])
+    if (!overwrite) {
+      warn('Aborted — nothing was changed.')
+      process.exit(0)
+    }
+  }
+
+  // ── 4. Scaffold ──────────────────────────────────────────────────────────
+  log()
+  sep()
+  log()
+
+  info(`Creating project "${c.bold}${projectName}${c.reset}"...`)
+  fs.ensureDirSync(target)
+  success('Directory created')
+
+  for (const dir of config.dirs) {
+    info(`Copying ${dir}/...`)
+    const src  = path.join(PKG_DIR, dir)
+    const dest = path.join(target, dir)
+    if (fs.existsSync(src)) {
+      const n = copyDir(src, dest)
+      success(`${dir}/ copied  ${c.dim}(${n} files)${c.reset}`)
+    } else {
+      warn(`${dir}/ not found in package — skipping`)
+    }
+  }
+
+  if (config.extras.includes('package.json')) {
+    info('Generating package.json...')
+    generatePackageJson(target, projectName)
+    success('package.json generated')
+  }
+
+  if (config.extras.includes('README.md')) {
+    info('Generating README.md...')
+    generateReadme(target, projectName)
+    success('README.md generated')
+  }
+
+  // ── 5. Done ──────────────────────────────────────────────────────────────
+  log()
+  sep()
+  log()
+  log(`  ${c.bold}${c.green}✔ Done!${c.reset}  "${projectName}" is ready.\n`)
+
+  log(`  ${c.bold}Next steps:${c.reset}\n`)
+  log(`    ${c.cyan}cd ${projectName}${c.reset}`)
+
+  if (scaffoldKey === 'full') {
+    log(`\n    Open in Claude Code:`)
+    log(`    ${c.cyan}claude .${c.reset}\n`)
+    log(`    Or open in Cursor / Windsurf — agents are auto-detected.`)
+  }
+
+  log()
+  dim(`Docs  https://raffles-agent-skills-kit.vercel.app/en`)
+  log()
+}

package/bin/commands/list.js

@@ -0,0 +1,40 @@
+'use strict'
+
+const path = require('path')
+const fs = require('fs')
+const { sep, log, c } = require('../utils/logger')
+
+const PKG_DIR = path.join(__dirname, '../..')
+
+module.exports = function list() {
+  const agentsDir = path.join(PKG_DIR, 'agents')
+
+  sep()
+  log(`\n  ${c.bold}Available Agents${c.reset}\n`)
+  sep()
+
+  if (!fs.existsSync(agentsDir)) {
+    log(`  ${c.red}No agents directory found.${c.reset}\n`)
+    return
+  }
+
+  const slugs = fs.readdirSync(agentsDir).filter(f =>
+    fs.statSync(path.join(agentsDir, f)).isDirectory()
+  )
+
+  for (const slug of slugs) {
+    try {
+      const raw = fs.readFileSync(path.join(agentsDir, slug, 'agent.yaml'), 'utf-8')
+      const model = (raw.match(/^model:\s*(.+)/m) || [])[1]?.trim() || ''
+      const isOpus = model.includes('opus')
+      const badge = isOpus
+        ? `${c.yellow}◆ Opus${c.reset}`
+        : `${c.cyan}● Sonnet${c.reset}`
+      log(`  ${c.green}${slug.padEnd(30)}${c.reset}${badge}`)
+    } catch {
+      log(`  ${c.dim}${slug}${c.reset}`)
+    }
+  }
+
+  log(`\n  ${c.dim}Total: ${slugs.length} agents${c.reset}\n`)
+}

package/bin/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+'use strict'
+
+const pkg = require('../package.json')
+
+const args = process.argv.slice(2)
+const cmd  = args[0]
+
+function run(fn) {
+  Promise.resolve(fn()).catch(err => {
+    console.error('\n  \x1b[31m' + (err.message || err) + '\x1b[0m\n')
+    process.exit(1)
+  })
+}
+
+switch (cmd) {
+  case undefined:
+    run(() => require('./commands/init')(args))
+    break
+
+  case 'init':
+    run(() => require('./commands/init')(args.slice(1)))
+    break
+
+  case 'list':
+    require('./commands/list')()
+    break
+
+  case '--version':
+  case '-v':
+    console.log(pkg.version)
+    break
+
+  case 'help':
+  case '--help':
+  case '-h':
+    require('./commands/help')()
+    break
+
+  default:
+    console.error(`\n  \x1b[31mUnknown command: ${cmd}\x1b[0m\n`)
+    require('./commands/help')()
+    process.exit(1)
+}

package/bin/utils/logger.js

@@ -0,0 +1,32 @@
+'use strict'
+
+const pkg = require('../../package.json')
+
+const c = {
+  reset:  '\x1b[0m',
+  bold:   '\x1b[1m',
+  dim:    '\x1b[2m',
+  blue:   '\x1b[34m',
+  cyan:   '\x1b[36m',
+  green:  '\x1b[32m',
+  yellow: '\x1b[33m',
+  red:    '\x1b[31m',
+}
+
+const sep = () => console.log(c.dim + '─'.repeat(56) + c.reset)
+
+const banner = () => {
+  sep()
+  console.log(`\n  ${c.bold}${c.blue}Raffles IT Kit${c.reset}  ${c.dim}v${pkg.version}${c.reset}`)
+  console.log(`  ${c.dim}AI Agent Enhancement Toolkit${c.reset}\n`)
+  sep()
+}
+
+const success = (msg) => console.log(`  ${c.green}✔${c.reset}  ${msg}`)
+const info    = (msg) => console.log(`  ${c.blue}◆${c.reset}  ${msg}`)
+const warn    = (msg) => console.log(`  ${c.yellow}⚠${c.reset}  ${msg}`)
+const error   = (msg) => console.log(`  ${c.red}✖${c.reset}  ${msg}`)
+const log     = (msg = '') => console.log(msg)
+const dim     = (msg) => console.log(`  ${c.dim}${msg}${c.reset}`)
+
+module.exports = { sep, banner, success, info, warn, error, log, dim, c }

package/bin/utils/scaffold.js

@@ -0,0 +1,114 @@
+'use strict'
+
+const path = require('path')
+const fs = require('fs-extra')
+
+/**
+ * Generate a package.json in the target directory.
+ */
+function generatePackageJson(targetDir, projectName) {
+  const safeName = projectName.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-_]/g, '')
+  const content = {
+    name: safeName,
+    version: '1.0.0',
+    description: `AI agent project scaffolded with raffles-it-kit`,
+    scripts: {
+      start: 'echo "Add your start script here"',
+      dev:   'echo "Add your dev script here"',
+    },
+    keywords: ['ai', 'agents', 'claude', 'raffles-it-kit'],
+    license: 'MIT',
+  }
+  fs.writeJsonSync(path.join(targetDir, 'package.json'), content, { spaces: 2 })
+}
+
+/**
+ * Generate a README.md in the target directory.
+ */
+function generateReadme(targetDir, projectName) {
+  const content = `# ${projectName}
+
+> AI Agent project scaffolded with [Raffles IT Kit](https://raffles-agent-skills-kit.vercel.app/en)
+
+## Getting Started
+
+\`\`\`bash
+# Open in Claude Code
+claude .
+
+# Or open in Cursor / Windsurf — agents are auto-detected from the workspace
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${projectName}/
+├── agents/        ← 19 specialist AI agent definitions
+├── skills/        ← 19 modular skill packs (SKILL.md files)
+├── workflows/     ← 11 slash command workflow definitions
+├── configs/       ← Model & runtime configuration
+├── prompts/       ← Shared prompt templates
+└── rules/         ← Editor-specific rules (Gemini, etc.)
+\`\`\`
+
+## Usage
+
+Agents are **automatically selected** based on your request. No configuration needed.
+
+\`\`\`
+You: "Create a responsive product card with Tailwind CSS and dark mode"
+AI:  Routing to frontend-specialist...
+     Loading skills: react-best-practices, tailwind-patterns, frontend-design
+
+You: "Build a JWT auth API with refresh tokens and rate limiting"
+AI:  Routing to backend-specialist...
+     Loading skills: api-patterns, nodejs-best-practices, clean-code
+
+You: "Our login endpoint returns 500 only in production"
+AI:  Routing to debugger...
+     Loading skills: systematic-debugging
+\`\`\`
+
+## Slash Commands
+
+| Command          | Description                                      |
+| ---------------- | ------------------------------------------------ |
+| \`/create\`        | Scaffold a new feature end-to-end                |
+| \`/debug\`         | Structured root-cause analysis                   |
+| \`/plan\`          | Break a large task into a sprint plan            |
+| \`/test\`          | Generate unit, integration, and E2E tests        |
+| \`/review\`        | Code review: OWASP, performance, conventions     |
+| \`/deploy\`        | Pre-flight checks → build → deploy → smoke test  |
+
+## Resources
+
+- [Documentation](https://raffles-agent-skills-kit.vercel.app/en)
+- [Getting Started Guide](https://raffles-agent-skills-kit.vercel.app/en/docs/guide)
+- [npm Package](https://www.npmjs.com/package/raffles-it-kit)
+- [GitHub](https://github.com/HaiTrieu0902/agent-skills-kit)
+`
+  fs.writeFileSync(path.join(targetDir, 'README.md'), content)
+}
+
+/**
+ * Copy a source directory into the target, skipping node_modules and .next.
+ */
+function copyDir(src, dest) {
+  if (!fs.existsSync(src)) return 0
+  fs.ensureDirSync(dest)
+  let count = 0
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (entry.name === 'node_modules' || entry.name === '.next') continue
+    const s = path.join(src, entry.name)
+    const d = path.join(dest, entry.name)
+    if (entry.isDirectory()) {
+      count += copyDir(s, d)
+    } else {
+      fs.copyFileSync(s, d)
+      count++
+    }
+  }
+  return count
+}
+
+module.exports = { generatePackageJson, generateReadme, copyDir }

package/configs/mcp_config.json

@@ -0,0 +1,24 @@
+{
+    "mcpServers": {
+        "context7": {
+            "command": "npx",
+            "args": [
+                "-y",
+                "@upstash/context7-mcp",
+                "--api-key",
+                "YOUR_API_KEY"
+            ]
+        },
+        "shadcn": {
+            "command": "npx",
+            "args": [
+                "shadcn@latest",
+                "mcp"
+            ]
+        }
+        //other mcp servers
+    }
+}
+
+// setup mcp server in  ~/.gemini\antigravity\mcp_config.json
+

package/configs/model.yaml

@@ -0,0 +1,20 @@
+# Model configuration for Antigravity Kit agents
+
+defaults:
+  model: claude-sonnet-4-6
+  max_tokens: 8192
+  temperature: 0
+
+overrides:
+  orchestrator:
+    model: claude-opus-4-6
+  code-archaeologist:
+    model: claude-opus-4-6
+
+available_models:
+  - id: claude-opus-4-6
+    description: Most capable — use for complex orchestration
+  - id: claude-sonnet-4-6
+    description: Balanced — default for most agents
+  - id: claude-haiku-4-5-20251001
+    description: Fast — use for simple, high-frequency tasks