@votruongdanh/ai-agent-skills 1.0.0

package/.kiro/skills/brainstorm/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: brainstorm
+description: Use when the user wants ideation, option generation, feature exploration, or types /brainstorm.
+---
+
+## Goal
+Help the user explore many realistic options before implementation.
+
+## Workflow
+1. Restate the problem in one or two sentences.
+2. Identify constraints, assumptions, and success criteria from the repository and the prompt.
+3. Produce 3-7 strong options with pros, cons, complexity, and risks.
+4. Call out the most practical option and the boldest option.
+5. End with a recommended next step or implementation path.
+
+## Output format
+- Problem framing
+- Constraints
+- Options
+- Recommendation
+- Next step
+
+## Rules
+- Prefer practical ideas grounded in the current project.
+- Avoid pretending uncertain assumptions are facts.
+- If code context matters, inspect the repo structure first.

package/.kiro/skills/create/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: create
+description: Use when the user wants to build a new feature, file, component, endpoint, page, script, or types /create.
+---
+
+## Goal
+Create a new implementation cleanly and with minimal disruption.
+
+## Workflow
+1. Understand the requested artifact and the existing project structure.
+2. Identify the smallest complete implementation that satisfies the request.
+3. Create or update the necessary files only.
+4. Reuse existing patterns, naming, and architecture already present in the repo.
+5. Add brief usage notes, edge cases, and follow-up improvements.
+
+## Rules
+- Prefer incremental changes over large rewrites.
+- Match the project's conventions.
+- Include basic validation and error handling.
+- If tests exist nearby, add or update them when appropriate.

package/.kiro/skills/debug/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: debug
+description: Use when the user wants root-cause analysis for a bug, failing command, broken behavior, error log, or types /debug.
+---
+
+## Goal
+Find the real root cause, not just the first visible symptom.
+
+## Workflow
+1. Summarize the bug, expected behavior, and actual behavior.
+2. Gather evidence from logs, stack traces, code paths, config, and recent changes.
+3. List the top hypotheses ranked by likelihood.
+4. Eliminate hypotheses using direct evidence.
+5. Identify the root cause.
+6. Propose the smallest safe fix.
+7. Suggest how to verify the fix and prevent regressions.
+
+## Output format
+- Symptom
+- Evidence
+- Hypotheses
+- Root cause
+- Fix
+- Verification
+
+## Rules
+- Do not guess when evidence is missing; say what must be checked.
+- Prefer deterministic reproduction steps.
+- Mention any hidden risk or side effect of the fix.

package/.kiro/skills/deploy/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: deploy
+description: Use when the user wants deployment steps, release preparation, environment setup, CI/CD guidance, production rollout, or types /deploy.
+---
+
+## Goal
+Prepare a safe, repeatable deployment or release plan.
+
+## Workflow
+1. Detect the app type, runtime, dependencies, and target environment.
+2. List prerequisites: secrets, env vars, build steps, infrastructure, database migrations, and health checks.
+3. Produce a deployment sequence from pre-checks to rollback.
+4. Call out risky steps explicitly.
+5. Include post-deploy verification and monitoring.
+
+## Output format
+- Target environment
+- Preconditions
+- Deployment steps
+- Verification
+- Rollback plan
+
+## Rules
+- Prefer least-risk rollout patterns.
+- Never expose secrets.
+- Distinguish clearly between required and optional steps.

package/.kiro/skills/enhance/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: enhance
+description: Use when the user wants to improve an existing feature, refactor code, optimize UX or performance, tighten security, or types /enhance.
+---
+
+## Goal
+Improve an existing implementation without breaking working behavior.
+
+## Workflow
+1. Understand the current state and pain points.
+2. Identify high-impact improvements in quality, maintainability, performance, reliability, or UX.
+3. Prioritize improvements by value versus effort.
+4. Implement or recommend the top changes.
+5. Explain tradeoffs and validation steps.
+
+## Rules
+- Preserve behavior unless the user asked for a behavior change.
+- Prefer small, meaningful upgrades over broad rewrites.
+- If performance is discussed, explain where the gain comes from.

package/.kiro/skills/orchestrate/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: orchestrate
+description: Use when the user wants a coordinated multi-step plan across multiple roles, files, systems, or parallel workstreams, or types /orchestrate.
+---
+
+## Goal
+Break a complex request into a coordinated execution plan.
+
+## Workflow
+1. Decompose the objective into workstreams.
+2. Assign each workstream a role, owner, or responsibility such as backend, frontend, QA, security, or docs.
+3. Identify dependencies, blockers, and the critical path.
+4. Define parallelizable tasks and merge points.
+5. Produce an execution order with clear handoffs.
+
+## Output format
+- Objective
+- Workstreams
+- Dependencies
+- Execution order
+- Risks
+- Done criteria
+
+## Rules
+- Keep plans realistic for the current project.
+- Surface unknowns early.
+- Favor visible checkpoints over long hidden work.

package/.kiro/skills/plan/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: plan
+description: Use when the user wants a concrete implementation plan, milestones, task breakdown, or types /plan.
+---
+
+## Goal
+Turn a request into an actionable plan.
+
+## Workflow
+1. Define the objective and acceptance criteria.
+2. Break the work into phases and tasks.
+3. Note file areas, systems, or modules likely to change.
+4. Estimate complexity and highlight risky items.
+5. End with a recommended first task.
+
+## Output format
+- Objective
+- Acceptance criteria
+- Phases
+- Tasks
+- Risks
+- First action
+
+## Rules
+- Plans should be specific enough to execute.
+- Prefer task sizes that can be completed and reviewed quickly.

package/.kiro/skills/preview/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: preview
+description: Use when the user wants a preview of expected output, UX, copy, interaction flow, generated content, or types /preview.
+---
+
+## Goal
+Show the user what the result will look or feel like before full rollout.
+
+## Workflow
+1. Infer the artifact being previewed: UI, API output, document, message, workflow, or report.
+2. Produce a faithful mock, sample output, walkthrough, or structured preview.
+3. Highlight assumptions behind the preview.
+4. Identify what could change during implementation.
+
+## Rules
+- Keep previews realistic and consistent with the current project.
+- Label illustrative content clearly when it is mock data.

package/.kiro/skills/status/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: status
+description: Use when the user wants a current project status summary, progress snapshot, repo overview, outstanding work, or types /status.
+---
+
+## Goal
+Summarize where things stand right now.
+
+## Workflow
+1. Inspect the repository, relevant files, and any recent context from the chat.
+2. Summarize what already exists.
+3. Identify gaps, risks, TODOs, and likely next priorities.
+4. Present a concise health/status view.
+
+## Output format
+- Current state
+- What is working
+- What is incomplete
+- Risks or blockers
+- Recommended next step
+
+## Rules
+- Be specific and evidence-based.
+- Separate facts from inference.

package/.kiro/skills/test/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: test
+description: Use when the user wants tests, test strategy, coverage improvements, validation steps, or types /test.
+---
+
+## Goal
+Improve confidence in the system through targeted testing.
+
+## Workflow
+1. Identify the unit, integration, API, UI, or regression scope.
+2. Enumerate critical paths, edge cases, and failure modes.
+3. Add or propose tests that cover the most important risks first.
+4. Explain how to run the tests and what passing means.
+
+## Rules
+- Prefer stable tests over brittle tests.
+- Cover both happy path and key edge cases.
+- If no test framework exists, propose the lightest practical option.

package/.kiro/skills/ui-ux-pro-max/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: ui-ux-pro-max
+description: Use when the user wants stronger UI/UX, layout improvements, design critique, copy refinement, interaction design, or types /ui-ux-pro-max.
+---
+
+## Goal
+Upgrade the product experience with clear, practical UI/UX improvements.
+
+## Workflow
+1. Identify the screen, flow, or component being improved.
+2. Evaluate hierarchy, spacing, clarity, accessibility, states, feedback, and conversion friction.
+3. Recommend concrete improvements with rationale.
+4. When asked to implement, favor polished but maintainable UI.
+
+## Output format
+- UX issues
+- Visual issues
+- Recommended changes
+- Accessibility notes
+- Implementation priorities
+
+## Rules
+- Optimize for clarity before decoration.
+- Respect existing brand and component patterns when present.
+- Include empty, loading, error, and success states when relevant.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vo Truong Danh (votruongdanh)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# 🚀 AI Agent Skills
+
+Professional AI agent skills for Kiro, Cursor, Windsurf, and other AI-powered IDEs. 11 battle-tested workflows to supercharge your development.
+
+[![npm version](https://img.shields.io/npm/v/@votruongdanh/ai-agent-skills.svg)](https://www.npmjs.com/package/@votruongdanh/ai-agent-skills)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ⚡ Quick Install
+
+One command, works everywhere:
+
+```bash
+npx @votruongdanh/ai-agent-skills init
+```
+
+That's it! No need to clone repos or download files.
+
+## 🎯 Supported IDEs
+
+✅ **Kiro** - Auto-detected  
+✅ **Cursor** - Auto-detected  
+✅ **Windsurf** - Auto-detected  
+✅ **Others** - Uses Kiro format
+
+The CLI automatically detects your IDE and installs to the right location.
+
+## 📦 11 Professional Skills
+
+| Skill | Command | Use Case |
+|-------|---------|----------|
+| **Brainstorm** | `/brainstorm` | Generate ideas and explore features |
+| **Create** | `/create` | Build new features from scratch |
+| **Debug** | `/debug` | Find and fix bugs systematically |
+| **Deploy** | `/deploy` | Deployment and CI/CD guidance |
+| **Enhance** | `/enhance` | Improve existing code quality |
+| **Orchestrate** | `/orchestrate` | Coordinate multi-step workflows |
+| **Plan** | `/plan` | Break down implementation tasks |
+| **Preview** | `/preview` | Preview UX and output |
+| **Status** | `/status` | Get project status overview |
+| **Test** | `/test` | Write tests and improve coverage |
+| **UI/UX Pro Max** | `/ui-ux-pro-max` | Advanced UI/UX improvements |
+
+## 💡 Usage Examples
+
+```
+/create Add user authentication with JWT
+/debug Login form not submitting on mobile
+/enhance Optimize database query performance
+/plan Implement real-time notifications
+```
+
+## 🌍 Installation Options
+
+### Project-specific (Recommended)
+```bash
+cd your-project
+npx @votruongdanh/ai-agent-skills init
+```
+
+### Global (All projects)
+```bash
+npx @votruongdanh/ai-agent-skills global
+```
+
+## 🔧 How It Works
+
+1. Run the npx command
+2. CLI detects your IDE automatically
+3. Skills installed to `.kiro/`, `.cursor/`, or `.windsurf/`
+4. Restart your IDE
+5. Type `/` in chat to see skills
+
+## ⚙️ Customization
+
+Each skill is a markdown file you can edit:
+
+```bash
+# For Kiro
+code .kiro/skills/create/SKILL.md
+
+# For Cursor
+code .cursor/skills/create/SKILL.md
+
+# For Windsurf
+code .windsurf/skills/create/SKILL.md
+```
+
+## 🔄 Updates
+
+```bash
+npx @votruongdanh/ai-agent-skills@latest init
+```
+
+## 📄 License
+
+MIT - Use freely in any project
+
+## 👤 Author
+
+**Vo Truong Danh**  
+GitHub: [@votruongdanh](https://github.com/votruongdanh)
+
+## 🤝 Contributing
+
+Issues and PRs welcome at [GitHub](https://github.com/votruongdanh/ai-agent-skills)
+
+---
+
+Made with ❤️ for the AI developer community

package/bin/cli.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const command = process.argv[2];
+
+// Detect IDE type
+function detectIDE() {
+  const cwd = process.cwd();
+  
+  // Check for Kiro
+  if (fs.existsSync(path.join(cwd, '.kiro'))) return 'kiro';
+  
+  // Check for Cursor
+  if (fs.existsSync(path.join(cwd, '.cursor'))) return 'cursor';
+  
+  // Check for Windsurf
+  if (fs.existsSync(path.join(cwd, '.windsurf'))) return 'windsurf';
+  
+  // Check home directory for global configs
+  const homeDir = os.homedir();
+  if (fs.existsSync(path.join(homeDir, '.kiro'))) return 'kiro';
+  if (fs.existsSync(path.join(homeDir, '.cursor'))) return 'cursor';
+  if (fs.existsSync(path.join(homeDir, '.windsurf'))) return 'windsurf';
+  
+  // Default to Kiro (most common)
+  return 'kiro';
+}
+
+function copyDirectory(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirectory(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function init() {
+  const cwd = process.cwd();
+  const ide = detectIDE();
+  const skillsSource = path.join(__dirname, '..', '.kiro');
+  const skillsTarget = path.join(cwd, `.${ide}`);
+
+  console.log(`🚀 Installing AI Agent Skills for ${ide.toUpperCase()}...\n`);
+
+  try {
+    if (fs.existsSync(skillsTarget)) {
+      console.log(`⚠️  .${ide} folder already exists.`);
+      console.log('   Merging skills into existing folder...\n');
+    }
+
+    copyDirectory(skillsSource, skillsTarget);
+
+    console.log('✅ Successfully installed AI Agent Skills!\n');
+    console.log(`📦 Installed to: .${ide}/skills/\n`);
+    console.log('📋 Available skills:');
+    console.log('   • /brainstorm    - Ideation and feature exploration');
+    console.log('   • /create        - Build new features and components');
+    console.log('   • /debug         - Root-cause analysis and bug fixing');
+    console.log('   • /deploy        - Deployment and release preparation');
+    console.log('   • /enhance       - Improve and refactor existing code');
+    console.log('   • /orchestrate   - Multi-step coordinated planning');
+    console.log('   • /plan          - Implementation planning and breakdown');
+    console.log('   • /preview       - Preview expected output and UX');
+    console.log('   • /status        - Project status and progress summary');
+    console.log('   • /test          - Test strategy and coverage');
+    console.log('   • /ui-ux-pro-max - UI/UX improvements and design\n');
+    console.log('🎯 Next steps:');
+    console.log(`   1. Reopen your project in ${ide.charAt(0).toUpperCase() + ide.slice(1)}`);
+    console.log('   2. Type "/" in chat to see available skills');
+    console.log('   3. Start using skills like /create, /debug, /enhance\n');
+  } catch (error) {
+    console.error('❌ Error installing skills:', error.message);
+    process.exit(1);
+  }
+}
+
+function installGlobal() {
+  const homeDir = os.homedir();
+  const ide = detectIDE();
+  const globalSkillsPath = path.join(homeDir, `.${ide}`, 'skills');
+  const skillsSource = path.join(__dirname, '..', '.kiro', 'skills');
+
+  console.log(`🌍 Installing AI Agent Skills globally for ${ide.toUpperCase()}...\n`);
+
+  try {
+    if (!fs.existsSync(globalSkillsPath)) {
+      fs.mkdirSync(globalSkillsPath, { recursive: true });
+    }
+
+    copyDirectory(skillsSource, globalSkillsPath);
+
+    console.log('✅ Successfully installed skills globally!\n');
+    console.log('📍 Location: ' + globalSkillsPath + '\n');
+    console.log('🎯 Next steps:');
+    console.log(`   1. Restart ${ide.charAt(0).toUpperCase() + ide.slice(1)}`);
+    console.log('   2. Skills will be available in all projects\n');
+  } catch (error) {
+    console.error('❌ Error installing global skills:', error.message);
+    process.exit(1);
+  }
+}
+
+function showHelp() {
+  console.log(`
+AI Agent Skills CLI - Universal skills for Kiro, Cursor, Windsurf & more
+
+Usage:
+  npx @votruongdanh/ai-agent-skills init       Install skills in current project
+  npx @votruongdanh/ai-agent-skills global     Install skills globally
+  npx @votruongdanh/ai-agent-skills help       Show this help message
+
+Supported IDEs:
+  ✅ Kiro      - Automatically detected
+  ✅ Cursor    - Automatically detected
+  ✅ Windsurf  - Automatically detected
+  ✅ Others    - Uses Kiro format by default
+
+Available Skills:
+  /brainstorm    - Ideation and feature exploration
+  /create        - Build new features and components
+  /debug         - Root-cause analysis and bug fixing
+  /deploy        - Deployment and release preparation
+  /enhance       - Improve and refactor existing code
+  /orchestrate   - Multi-step coordinated planning
+  /plan          - Implementation planning and breakdown
+  /preview       - Preview expected output and UX
+  /status        - Project status and progress summary
+  /test          - Test strategy and coverage
+  /ui-ux-pro-max - UI/UX improvements and design
+
+Documentation: https://github.com/votruongdanh/ai-agent-skills
+`);
+}
+
+switch (command) {
+  case 'init':
+    init();
+    break;
+  case 'global':
+    installGlobal();
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    showHelp();
+    break;
+  default:
+    console.log('❌ Unknown command. Use "init", "global", or "help".\n');
+    showHelp();
+    process.exit(1);
+}

package/index.js

@@ -0,0 +1,31 @@
+/**
+ * Kiro Antigravity Skills
+ * Professional AI agent skills for Kiro IDE and compatible platforms
+ */
+
+/**
+ * AI Agent Skills by Vo Truong Danh
+ * Professional AI agent skills for Kiro, Cursor, Windsurf, and other AI IDEs
+ * 
+ * @author Vo Truong Danh <votruongdanh@example.com>
+ * @license MIT
+ */
+
+module.exports = {
+  name: '@votruongdanh/ai-agent-skills',
+  version: require('./package.json').version,
+  author: 'Vo Truong Danh (votruongdanh)',
+  skills: [
+    'brainstorm',
+    'create',
+    'debug',
+    'deploy',
+    'enhance',
+    'orchestrate',
+    'plan',
+    'preview',
+    'status',
+    'test',
+    'ui-ux-pro-max'
+  ]
+};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@votruongdanh/ai-agent-skills",
+  "version": "1.0.0",
+  "description": "Professional AI Agent Skills - 11 powerful workflows for Kiro, Cursor, Windsurf, and other AI IDEs",
+  "main": "index.js",
+  "bin": {
+    "ai-skills": "bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"No tests specified\" && exit 0"
+  },
+  "keywords": [
+    "kiro",
+    "cursor",
+    "windsurf",
+    "ai",
+    "agent",
+    "skills",
+    "ide",
+    "development",
+    "workflow",
+    "automation",
+    "productivity",
+    "copilot"
+  ],
+  "author": {
+    "name": "Vo Truong Danh",
+    "email": "votruongdanh@example.com",
+    "url": "https://github.com/votruongdanh"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/votruongdanh/ai-agent-skills.git"
+  },
+  "bugs": {
+    "url": "https://github.com/votruongdanh/ai-agent-skills/issues"
+  },
+  "homepage": "https://github.com/votruongdanh/ai-agent-skills#readme",
+  "files": [
+    ".kiro",
+    "bin",
+    "index.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}