diff --git a/CHANGELOG.md b/CHANGELOG.md index 6a1b988f..765b301a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 --- +## [5.10.0] - 2026-02-21 - "AWS Kiro CLI Integration" + +> **Native support and integration guide for AWS Kiro CLI, expanding the repository's reach to the AWS developer community.** + +This release adds comprehensive support for Kiro CLI, AWS's recently launched agentic IDE, enabling 883+ skills to enhance Kiro's autonomous operations across serverless, IaC, and AWS architectures. It also includes an important bugfix for the npm installer CLI. + +## ๐Ÿš€ Improvements + +- **Integration Guide**: Added `docs/KIRO_INTEGRATION.md` detailing Kiro capabilities, installation instructions, AWS-recommended skills, and MCP usage. +- **Documentation**: Updated `README.md`, `docs/GETTING_STARTED.md`, and `docs/FAQ.md` to formally support Kiro CLI and add invocation examples. +- **Installer**: Added the `--kiro` flag to the CLI installer (`bin/install.js`) which correctly targets `~/.kiro/skills`. + +## ๐Ÿ› Bug Fixes + +- **Installer Path Consistency**: Fixed Issue #105 where the published `v5.9.0` npm install script contained an older version of `bin/install.js`, causing `--antigravity` installs to mistakenly target `.agent/skills` instead of the global `~/.gemini/antigravity/skills`. This release (`5.10.0`) properly bundles the corrected npm install script. + +## ๐Ÿ‘ฅ Credits + +A huge shoutout to our community contributors: + +- **@ssumanbiswas** for the Kiro CLI support (PR #104) + +--- + ## [5.9.0] - 2026-02-20 - "Apple HIG & Quality Bar" > **Extensive Apple design guidelines and strict validation for the entire registry.** diff --git a/README.md b/README.md index b94865b8..6f86bae4 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,7 @@ [![Claude Code](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)](https://claude.ai) [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Google-blue)](https://github.com/google-gemini/gemini-cli) [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-OpenAI-green)](https://github.com/openai/codex) +[![Kiro CLI](https://img.shields.io/badge/Kiro%20CLI-AWS-orange)](https://kiro.dev) [![Cursor](https://img.shields.io/badge/Cursor-AI%20IDE-orange)](https://cursor.sh) [![Copilot](https://img.shields.io/badge/GitHub%20Copilot-VSCode-lightblue)](https://github.com/features/copilot) [![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray)](https://github.com/opencode-ai/opencode) @@ -21,6 +22,7 @@ If this project helps you, you can [support it here](https://buymeacoffee.com/si - ๐ŸŸฃ **Claude Code** (Anthropic CLI) - ๐Ÿ”ต **Gemini CLI** (Google DeepMind) - ๐ŸŸข **Codex CLI** (OpenAI) +- ๐ŸŸ  **Kiro CLI** (AWS) - ๐Ÿ”ด **Antigravity IDE** (Google DeepMind) - ๐Ÿฉต **GitHub Copilot** (VSCode Extension) - ๐ŸŸ  **Cursor** (AI-native IDE) @@ -53,11 +55,11 @@ This repository provides essential skills to transform your AI assistant into a ## New Here? Start Here! -**Welcome to the V5.9.0 Workflows Edition.** This isn't just a list of scripts; it's a complete operating system for your AI Agent. +**Welcome to the V5.10.0 Workflows Edition.** This isn't just a list of scripts; it's a complete operating system for your AI Agent. ### 1. ๐Ÿฃ Context: What is this? -**Antigravity Awesome Skills** (Release 5.9.0) is a massive upgrade to your AI's capabilities. +**Antigravity Awesome Skills** (Release 5.10.0) is a massive upgrade to your AI's capabilities. AI Agents (like Claude Code, Cursor, or Gemini) are smart, but they lack **specific tools**. They don't know your company's "Deployment Protocol" or the specific syntax for "AWS CloudFormation". **Skills** are small markdown files that teach them how to do these specific tasks perfectly, every time. @@ -105,16 +107,17 @@ Once installed, just ask your agent naturally: These skills follow the universal **SKILL.md** format and work with any AI coding assistant that supports agentic skills. -| Tool | Type | Invocation Example | Path | -| :-------------- | :--- | :-------------------------------- | :---------------- | -| **Claude Code** | CLI | `>> /skill-name help me...` | `.claude/skills/` | -| **Gemini CLI** | CLI | `(User Prompt) Use skill-name...` | `.gemini/skills/` | -| **Codex CLI** | CLI | `(User Prompt) Use skill-name...` | `.codex/skills/` | +| Tool | Type | Invocation Example | Path | +| :-------------- | :--- | :-------------------------------- | :-------------------------------------------------------------------- | +| **Claude Code** | CLI | `>> /skill-name help me...` | `.claude/skills/` | +| **Gemini CLI** | CLI | `(User Prompt) Use skill-name...` | `.gemini/skills/` | +| **Codex CLI** | CLI | `(User Prompt) Use skill-name...` | `.codex/skills/` | +| **Kiro CLI** | CLI | `(User Prompt) Use skill-name...` | `.kiro/skills/` | | **Antigravity** | IDE | `(Agent Mode) Use skill...` | Global: `~/.gemini/antigravity/skills/` ยท Workspace: `.agent/skills/` | -| **Cursor** | IDE | `@skill-name (in Chat)` | `.cursor/skills/` | -| **Copilot** | Ext | `(Paste content manually)` | N/A | -| **OpenCode** | CLI | `opencode run @skill-name` | `.agents/skills/` | -| **AdaL CLI** | CLI | `(Auto) Skills load on-demand` | `.adal/skills/` | +| **Cursor** | IDE | `@skill-name (in Chat)` | `.cursor/skills/` | +| **Copilot** | Ext | `(Paste content manually)` | N/A | +| **OpenCode** | CLI | `opencode run @skill-name` | `.agents/skills/` | +| **AdaL CLI** | CLI | `(Auto) Skills load on-demand` | `.adal/skills/` | > [!TIP] > **Default installer path**: `~/.gemini/antigravity/skills` (Antigravity global). Use `--path ~/.agent/skills` for workspace-specific install. For manual clone, `.agent/skills/` works as workspace path for Antigravity. @@ -151,6 +154,9 @@ npx antigravity-awesome-skills --gemini # Codex CLI npx antigravity-awesome-skills --codex +# Kiro CLI +npx antigravity-awesome-skills --kiro + # OpenCode npx antigravity-awesome-skills --path .agents/skills @@ -183,6 +189,9 @@ git clone https://github.com/sickn33/antigravity-awesome-skills.git .gemini/skil # Codex CLI specific git clone https://github.com/sickn33/antigravity-awesome-skills.git .codex/skills +# Kiro CLI specific +git clone https://github.com/sickn33/antigravity-awesome-skills.git .kiro/skills + # Cursor specific git clone https://github.com/sickn33/antigravity-awesome-skills.git .cursor/skills @@ -246,11 +255,13 @@ They help you avoid picking from 883+ skills one by one. **Answer: NO!** Here's what bundles actually are: **What bundles ARE:** + - โœ… Recommended skill lists organized by role - โœ… Curated starting points to help you decide what to use - โœ… Time-saving shortcuts for discovering relevant skills **What bundles are NOT:** + - โŒ Separate installations or downloads - โŒ Different git commands - โŒ Something you need to "activate" diff --git a/assets/star-history.png b/assets/star-history.png index e696fdee..aeaa81de 100644 Binary files a/assets/star-history.png and b/assets/star-history.png differ diff --git a/bin/install.js b/bin/install.js index f9d3bd14..03bc079c 100755 --- a/bin/install.js +++ b/bin/install.js @@ -23,7 +23,8 @@ function parseArgs() { claude = false, gemini = false, codex = false, - antigravity = false; + antigravity = false, + kiro = false; for (let i = 0; i < a.length; i++) { if (a[i] === "--help" || a[i] === "-h") return { help: true }; @@ -59,6 +60,10 @@ function parseArgs() { antigravity = true; continue; } + if (a[i] === "--kiro") { + kiro = true; + continue; + } if (a[i] === "install") continue; } @@ -71,6 +76,7 @@ function parseArgs() { gemini, codex, antigravity, + kiro, }; } @@ -84,6 +90,7 @@ function defaultDir(opts) { if (codexHome) return path.join(codexHome, "skills"); return path.join(HOME, ".codex", "skills"); } + if (opts.kiro) return path.join(HOME, ".kiro", "skills"); if (opts.antigravity) return path.join(HOME, ".gemini", "antigravity", "skills"); return path.join(HOME, ".gemini", "antigravity", "skills"); @@ -102,6 +109,7 @@ Options: --claude Install to ~/.claude/skills (Claude Code) --gemini Install to ~/.gemini/skills (Gemini CLI) --codex Install to ~/.codex/skills (Codex CLI) + --kiro Install to ~/.kiro/skills (Kiro CLI) --antigravity Install to ~/.gemini/antigravity/skills (Antigravity) --path Install to (default: ~/.gemini/antigravity/skills) --version After clone, checkout tag v (e.g. 4.6.0 -> v4.6.0) @@ -110,6 +118,7 @@ Options: Examples: npx antigravity-awesome-skills npx antigravity-awesome-skills --cursor + npx antigravity-awesome-skills --kiro npx antigravity-awesome-skills --antigravity npx antigravity-awesome-skills --version 4.6.0 npx antigravity-awesome-skills --path ./my-skills diff --git a/docs/KIRO_INTEGRATION.md b/docs/KIRO_INTEGRATION.md new file mode 100644 index 00000000..f5706181 --- /dev/null +++ b/docs/KIRO_INTEGRATION.md @@ -0,0 +1,292 @@ +# Kiro CLI Integration Guide + +## Overview + +This guide explains how to use Antigravity Awesome Skills with **Kiro CLI**, AWS's agentic AI-powered coding assistant. + +## What is Kiro? + +Kiro is AWS's agentic AI IDE that combines: +- **Autonomous coding agents** that work independently for extended periods +- **Context-aware assistance** with deep understanding of your codebase +- **AWS service integration** with native support for CDK, SAM, and Terraform +- **MCP (Model Context Protocol)** for secure external API and database calls +- **Spec-driven development** that turns natural language into structured specifications + +## Why Use Skills with Kiro? + +Kiro's agentic capabilities are enhanced by skills that provide: +- **Domain expertise** across 883+ specialized areas +- **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS +- **Workflow automation** for common development tasks +- **AWS-specific patterns** for serverless, infrastructure, and cloud architecture + +## Installation + +### Quick Install + +```bash +# Install to Kiro's default skills directory +npx antigravity-awesome-skills --kiro +``` + +This installs skills to `~/.kiro/skills/` + +### Manual Installation + +```bash +# Clone directly to Kiro's skills directory +git clone https://github.com/sickn33/antigravity-awesome-skills.git ~/.kiro/skills +``` + +### Verification + +```bash +# Verify installation +test -d ~/.kiro/skills && echo "โœ“ Skills installed successfully" +ls ~/.kiro/skills/skills/ | head -10 +``` + +## Using Skills with Kiro + +### Basic Invocation + +Kiro uses natural language prompts to invoke skills: + +``` +Use the @brainstorming skill to help me design a serverless API +``` + +``` +Apply @aws-serverless patterns to this Lambda function +``` + +``` +Run @security-audit on my CDK stack +``` + +### Recommended Skills for Kiro Users + +#### AWS & Cloud Infrastructure +- `@aws-serverless` - Serverless architecture patterns +- `@aws-cdk` - AWS CDK best practices +- `@aws-sam` - SAM template patterns +- `@terraform-expert` - Terraform infrastructure as code +- `@docker-expert` - Container optimization +- `@kubernetes-expert` - K8s deployment patterns + +#### Architecture & Design +- `@architecture` - System design and ADRs +- `@c4-context` - C4 model diagrams +- `@senior-architect` - Scalable architecture patterns +- `@microservices-patterns` - Microservices design + +#### Security +- `@api-security-best-practices` - API security hardening +- `@vulnerability-scanner` - Security vulnerability detection +- `@owasp-top-10` - OWASP security patterns +- `@aws-security-best-practices` - AWS security configuration + +#### Development +- `@typescript-expert` - TypeScript best practices +- `@python-patterns` - Python design patterns +- `@react-patterns` - React component patterns +- `@test-driven-development` - TDD workflows + +#### DevOps & Automation +- `@ci-cd-pipeline` - CI/CD automation +- `@github-actions` - GitHub Actions workflows +- `@monitoring-observability` - Observability patterns +- `@incident-response` - Incident management + +## Kiro-Specific Workflows + +### 1. Serverless Application Development + +``` +1. Use @brainstorming to design the application architecture +2. Apply @aws-serverless to create Lambda functions +3. Use @aws-cdk to generate infrastructure code +4. Run @test-driven-development to add tests +5. Apply @ci-cd-pipeline to set up deployment +``` + +### 2. Infrastructure as Code + +``` +1. Use @architecture to document the system design +2. Apply @terraform-expert to write Terraform modules +3. Run @security-audit to check for vulnerabilities +4. Use @documentation to generate README and runbooks +``` + +### 3. API Development + +``` +1. Use @api-design to plan endpoints +2. Apply @typescript-expert for implementation +3. Run @api-security-best-practices for hardening +4. Use @openapi-spec to generate documentation +``` + +## Advanced Features + +### MCP Integration + +Kiro's MCP support allows skills to: +- Call external APIs securely +- Query databases with context +- Integrate with AWS services +- Access documentation in real-time + +Skills that leverage MCP: +- `@rag-engineer` - RAG system implementation +- `@langgraph` - Agent workflow orchestration +- `@prompt-engineer` - LLM prompt optimization + +### Autonomous Operation + +Kiro can work independently for extended periods. Use skills to guide long-running tasks: + +``` +Use @systematic-debugging to investigate and fix all TypeScript errors in the codebase, +then apply @test-driven-development to add missing tests, and finally run @documentation +to update all README files. +``` + +### Context-Aware Assistance + +Kiro maintains deep context. Reference multiple skills in complex workflows: + +``` +I'm building a SaaS application. Use @brainstorming for the MVP plan, +@aws-serverless for the backend, @react-patterns for the frontend, +@stripe-integration for payments, and @security-audit for hardening. +``` + +## Bundles for Kiro Users + +Pre-curated skill collections optimized for common Kiro use cases: + +### AWS Developer Bundle +- `@aws-serverless` +- `@aws-cdk` +- `@aws-sam` +- `@lambda-best-practices` +- `@dynamodb-patterns` +- `@api-gateway-patterns` + +### Full-Stack AWS Bundle +- `@aws-serverless` +- `@react-patterns` +- `@typescript-expert` +- `@api-design` +- `@test-driven-development` +- `@ci-cd-pipeline` + +### DevOps & Infrastructure Bundle +- `@terraform-expert` +- `@docker-expert` +- `@kubernetes-expert` +- `@monitoring-observability` +- `@incident-response` +- `@security-audit` + +See [BUNDLES.md](BUNDLES.md) for complete bundle listings. + +## Troubleshooting + +### Skills Not Loading + +```bash +# Check installation path +ls -la ~/.kiro/skills/ + +# Reinstall if needed +rm -rf ~/.kiro/skills +npx antigravity-awesome-skills --kiro +``` + +### Skill Not Found + +Ensure you're using the correct skill name: + +```bash +# List all available skills +ls ~/.kiro/skills/skills/ +``` + +### Permission Issues + +```bash +# Fix permissions +chmod -R 755 ~/.kiro/skills/ +``` + +## Best Practices + +1. **Start with bundles** - Use pre-curated collections for your role +2. **Combine skills** - Reference multiple skills in complex tasks +3. **Be specific** - Clearly state which skill to use and what to do +4. **Iterate** - Let Kiro work autonomously, then refine with additional skills +5. **Document** - Use `@documentation` to keep your codebase well-documented + +## Examples + +### Example 1: Build a Serverless API + +``` +I need to build a REST API for a todo application using AWS Lambda and DynamoDB. + +Use @brainstorming to design the architecture, then apply @aws-serverless +to implement the Lambda functions, @dynamodb-patterns for data modeling, +and @api-security-best-practices for security hardening. + +Generate the infrastructure using @aws-cdk and add tests with @test-driven-development. +``` + +### Example 2: Migrate to Microservices + +``` +I want to break down this monolithic application into microservices. + +Use @architecture to create an ADR for the migration strategy, +apply @microservices-patterns for service boundaries, +@docker-expert for containerization, and @kubernetes-expert for orchestration. + +Document the migration plan with @documentation. +``` + +### Example 3: Security Audit + +``` +Perform a comprehensive security audit of this application. + +Use @security-audit to scan for vulnerabilities, @owasp-top-10 to check +for common issues, @api-security-best-practices for API hardening, +and @aws-security-best-practices for cloud configuration. + +Generate a report with findings and remediation steps. +``` + +## Resources + +- [Kiro Official Documentation](https://kiro.dev) +- [AWS Blog: Transform DevOps with Kiro](https://aws.amazon.com/blogs/publicsector/transform-devops-practice-with-kiro-ai-powered-agents/) +- [Complete Skills Catalog](../CATALOG.md) +- [Usage Guide](USAGE.md) +- [Workflow Examples](WORKFLOWS.md) + +## Contributing + +Found a Kiro-specific use case or workflow? Contribute to this guide: + +1. Fork the repository +2. Add your examples to this file +3. Submit a pull request + +## Support + +- **Issues**: [GitHub Issues](https://github.com/sickn33/antigravity-awesome-skills/issues) +- **Discussions**: [GitHub Discussions](https://github.com/sickn33/antigravity-awesome-skills/discussions) +- **Community**: [Community Guidelines](COMMUNITY_GUIDELINES.md) diff --git a/package.json b/package.json index 27acbc94..6ccc937a 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "antigravity-awesome-skills", - "version": "5.9.0", + "version": "5.10.0", "description": "883+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.", "license": "MIT", "scripts": {