413 lines
15 KiB
Markdown
413 lines
15 KiB
Markdown
# Antigravity ClaudeKit Skills - Codebase Summary
|
|
|
|
**Generated:** 2026-02-16
|
|
**Version:** 1.0.0
|
|
|
|
## Project Overview
|
|
|
|
Antigravity ClaudeKit Skills is a production-ready conversion of ClaudeKit's comprehensive AI development workflow into a standalone Antigravity IDE skill collection. It provides 76 focused skills covering planning, coding, testing, review, debugging, deployment, and specialized domains—fully independent of ClaudeKit IDE dependencies.
|
|
|
|
## Repository Structure
|
|
|
|
```
|
|
antigravity-claudekit/
|
|
├── skills/ # 76 skill implementations
|
|
│ ├── ck-brainstorm/ # Design & ideation
|
|
│ ├── ck-planning/ # Project planning
|
|
│ ├── ck-code-review/ # Code quality review
|
|
│ ├── ck-debug/ # Bug investigation
|
|
│ ├── ck-fix/ # Bug fixing
|
|
│ ├── ck-fixing/ # Enhanced bug fixing
|
|
│ ├── ck-git/ # Git operations
|
|
│ ├── ck-scout/ # Codebase exploration
|
|
│ ├── ck-research/ # Technical research
|
|
│ ├── ck-sequential-thinking/ # Complex problem solving
|
|
│ ├── ck-cook/ # Recipe & pattern sharing
|
|
│ ├── ck-frontend-design/ # UI/UX design
|
|
│ │
|
|
│ ├── ck-frontend-development/ # React/Vue/Angular
|
|
│ ├── ck-backend-development/ # Node/Python/Java
|
|
│ ├── ck-web-frameworks/ # Framework-specific
|
|
│ ├── ck-databases/ # Database design & queries
|
|
│ ├── ck-devops/ # Deployment & infrastructure
|
|
│ ├── ck-web-testing/ # Testing strategies
|
|
│ │
|
|
│ ├── ck-mobile-development/ # iOS/Android
|
|
│ ├── ck-payment-integration/ # Stripe, PayPal
|
|
│ ├── ck-ai-artist/ # Image generation (DALL-E, Midjourney)
|
|
│ ├── ck-ai-multimodal/ # Multimodal processing
|
|
│ ├── ck-chrome-devtools/ # Browser automation
|
|
│ ├── ck-media-processing/ # Audio/video/image
|
|
│ ├── ck-shader/ # GLSL shader programming
|
|
│ ├── ck-threejs/ # Three.js 3D graphics
|
|
│ ├── ck-remotion/ # Video production
|
|
│ ├── ck-shopify/ # Shopify development
|
|
│ ├── [16+ more specialized skills]
|
|
│ │
|
|
│ ├── ck-privacy-guard/ # Privacy & secrets protection
|
|
│ ├── ck-code-quality-guard/ # Code quality enforcement
|
|
│ ├── ck-session-guard/ # Session management
|
|
│ ├── ck-context-guard/ # Context size management
|
|
│ ├── ck-orchestration/ # Workflow orchestration
|
|
│ │
|
|
│ ├── ck-ask/ # Question answering
|
|
│ ├── ck-bootstrap/ # Project bootstrapping
|
|
│ ├── ck-plan/ # Planning command
|
|
│ ├── ck-test/ # Testing command
|
|
│ ├── ck-preview/ # Preview generation
|
|
│ ├── ck-worktree/ # Git worktree management
|
|
│ ├── ck-help/ # Help system
|
|
│ ├── ck-ccs/ # Custom code search
|
|
│ ├── ck-docs-manager/ # Documentation management
|
|
│ ├── ck-project-manager/ # Project management
|
|
│ └── [9+ more commands/agents]
|
|
│
|
|
├── templates/
|
|
│ └── SKILL.md # Template for new skills
|
|
│
|
|
├── docs/
|
|
│ ├── project-overview-pdr.md # Project PDR
|
|
│ ├── codebase-summary.md # Code structure (this file)
|
|
│ ├── migration-guide-from-claudekit.md
|
|
│ ├── project-changelog.md
|
|
│ └── skill-categories-guide.md
|
|
│
|
|
├── skills_index.json # Central skill registry
|
|
├── README.md # Quick start & overview
|
|
├── CHANGELOG.md # Version history
|
|
├── LICENSE # MIT license
|
|
├── install.sh # Bash installer
|
|
├── install.ps1 # PowerShell installer
|
|
└── .gitignore
|
|
```
|
|
|
|
## Skill Inventory (76 Total)
|
|
|
|
### Core Workflow (12 skills)
|
|
**Purpose:** Planning, development, review, and debugging workflow
|
|
|
|
1. **ck-brainstorm** - Design alternatives and feature ideas
|
|
2. **ck-planning** - Project planning from requirements
|
|
3. **ck-code-review** - Security and quality review
|
|
4. **ck-debug** - Bug investigation and diagnosis
|
|
5. **ck-fix** - Bug fixing assistance
|
|
6. **ck-fixing** - Enhanced bug fixing with advanced analysis
|
|
7. **ck-git** - Git operations and workflows
|
|
8. **ck-scout** - Codebase exploration and mapping
|
|
9. **ck-research** - Technical research and documentation
|
|
10. **ck-sequential-thinking** - Complex problem decomposition
|
|
11. **ck-cook** - Recipe/pattern sharing and reuse
|
|
12. **ck-frontend-design** - UI/UX design patterns
|
|
|
|
### Development (14 skills)
|
|
**Purpose:** Language and framework-specific development
|
|
|
|
1. **ck-frontend-development** - React, Vue, Angular
|
|
2. **ck-backend-development** - Node, Python, Java, Go
|
|
3. **ck-web-frameworks** - Django, Flask, FastAPI, Express, Nest.js
|
|
4. **ck-databases** - SQL design, optimization, migration
|
|
5. **ck-devops** - Docker, Kubernetes, CI/CD
|
|
6. **ck-web-testing** - Jest, Mocha, Cypress, Selenium
|
|
7. **ck-typescript** - TypeScript advanced patterns
|
|
8. **ck-javascript** - JavaScript ES6+ and quirks
|
|
9. **ck-python** - Python patterns and best practices
|
|
10. **ck-rust** - Rust ownership and concurrency
|
|
11. **ck-go** - Go concurrency and interfaces
|
|
12. **ck-java** - Java patterns and Spring Boot
|
|
13. **ck-csharp** - C# and .NET Framework
|
|
14. **ck-sql** - SQL optimization and database design
|
|
|
|
### Specialized Domains (26 skills)
|
|
**Purpose:** Niche technical expertise and AI tools
|
|
|
|
#### Mobile & Native
|
|
- **ck-mobile-development** - iOS and Android development
|
|
- **ck-react-native** - React Native cross-platform
|
|
- **ck-flutter** - Flutter framework
|
|
- **ck-native-ios** - Swift/Objective-C
|
|
|
|
#### AI & Machine Learning
|
|
- **ck-ai-artist** - Image generation (DALL-E, Midjourney)
|
|
- **ck-ai-multimodal** - Vision, audio, video processing
|
|
- **ck-machine-learning** - Model training, TensorFlow, PyTorch
|
|
- **ck-nlp** - Natural language processing
|
|
|
|
#### Graphics & Media
|
|
- **ck-shader** - GLSL/HLSL shader programming
|
|
- **ck-threejs** - Three.js 3D graphics
|
|
- **ck-babylon** - Babylon.js alternative
|
|
- **ck-canvas** - HTML5 Canvas and WebGL
|
|
- **ck-remotion** - Remotion video production
|
|
- **ck-media-processing** - Audio, video, image manipulation
|
|
|
|
#### Web & E-Commerce
|
|
- **ck-shopify** - Shopify app development
|
|
- **ck-payment-integration** - Stripe, PayPal, Square
|
|
- **ck-seo** - SEO optimization
|
|
- **ck-web-accessibility** - a11y best practices
|
|
- **ck-performance** - Web performance optimization
|
|
|
|
#### DevTools & Automation
|
|
- **ck-chrome-devtools** - Browser automation
|
|
- **ck-mcp-management** - MCP protocol tools
|
|
- **ck-agent-browser** - Agent-based browsing
|
|
|
|
#### Blockchain & Web3
|
|
- **ck-smart-contracts** - Solidity, Web3.js
|
|
- **ck-defi** - DeFi protocols and patterns
|
|
|
|
### Guard Skills (5 skills)
|
|
**Purpose:** Quality, privacy, and workflow enforcement
|
|
|
|
1. **ck-privacy-guard** - Secrets and sensitive data protection
|
|
2. **ck-code-quality-guard** - Syntax, linting, standards
|
|
3. **ck-session-guard** - Conversation session management
|
|
4. **ck-context-guard** - Token/context size management
|
|
5. **ck-orchestration** - Workflow sequence enforcement
|
|
|
|
### Commands & Agents (19 skills)
|
|
**Purpose:** CLI tools and specialized manager surfaces
|
|
|
|
#### Commands
|
|
1. **ck-ask** - Question answering
|
|
2. **ck-bootstrap** - Project template generation
|
|
3. **ck-plan** - Planning command
|
|
4. **ck-test** - Testing command
|
|
5. **ck-preview** - Visual explanation generation
|
|
6. **ck-worktree** - Git worktree management
|
|
7. **ck-help** - Context-aware help
|
|
|
|
#### Manager Surfaces & Agents
|
|
8. **ck-ccs** - Custom code search
|
|
9. **ck-docs-manager** - Documentation management
|
|
10. **ck-project-manager** - Project and team management
|
|
11. **ck-fullstack-developer** - Full-stack development agent
|
|
12. **ck-code-simplifier** - Code simplification assistant
|
|
13. **ck-brainstormer** - Creative ideation agent
|
|
14. **ck-journal-writer** - Technical documentation writer
|
|
15. **ck-code-quality-agent** - Quality assurance agent
|
|
16. **ck-performance-analyst** - Performance optimization
|
|
17. **ck-security-analyst** - Security review agent
|
|
18. **ck-architect** - Architecture design agent
|
|
19. **ck-ci-cd-specialist** - CI/CD pipeline expert
|
|
|
|
## Skill Metadata Format
|
|
|
|
All skills use consistent frontmatter:
|
|
|
|
```json
|
|
{
|
|
"id": "ck-code-review",
|
|
"name": "Code Review Assistant",
|
|
"category": "ck-core",
|
|
"version": "1.0.0",
|
|
"triggers": ["review", "code review", "quality check"],
|
|
"description": "Review code for security, performance, and best practices",
|
|
"proficiencyLevel": "advanced",
|
|
"estimatedTime": "5-15 minutes",
|
|
"prerequisites": [],
|
|
"hardGates": [],
|
|
"examples": [
|
|
"Review my authentication middleware for security issues",
|
|
"Check if this React component follows best practices"
|
|
]
|
|
}
|
|
```
|
|
|
|
## Categories & Organization
|
|
|
|
### By Complexity Level
|
|
|
|
| Level | Count | Skills | Use Case |
|
|
|-------|-------|--------|----------|
|
|
| **Beginner** | 12 | ck-brainstorm, ck-ask, ck-help, etc. | Getting started, learning |
|
|
| **Intermediate** | 38 | ck-code-review, ck-frontend-dev, ck-databases | Daily development |
|
|
| **Advanced** | 20 | ck-sequential-thinking, ck-architecture, ck-shader | Complex problems |
|
|
| **Specialist** | 6 | AI, blockchain, payment, media | Niche expertise |
|
|
|
|
### By Use Case
|
|
|
|
| Use Case | Count | Primary Skills |
|
|
|----------|-------|-----------------|
|
|
| **Planning** | 4 | ck-brainstorm, ck-planning, ck-project-manager |
|
|
| **Development** | 28 | ck-frontend-dev, ck-backend-dev, framework-specific |
|
|
| **Testing** | 5 | ck-web-testing, ck-test, quality guards |
|
|
| **Review** | 6 | ck-code-review, quality guards, security-analyst |
|
|
| **Debugging** | 4 | ck-debug, ck-fix, ck-fixing, ck-sequential-thinking |
|
|
| **Deployment** | 4 | ck-devops, ck-ci-cd-specialist, ck-worktree |
|
|
| **Documentation** | 3 | ck-docs-manager, ck-journal-writer, ck-cook |
|
|
| **Specialized** | 22 | Mobile, AI, graphics, payment, e-commerce |
|
|
|
|
## Code Quality Metrics
|
|
|
|
### Validation Results (✓ Passed)
|
|
|
|
| Check | Target | Result | Status |
|
|
|-------|--------|--------|--------|
|
|
| Total Skills | 76 | 76 | ✓ |
|
|
| Valid Frontmatter | 100% | 100% | ✓ |
|
|
| Task References | 0 | 0 | ✓ |
|
|
| Hook References | 0 | 0 | ✓ |
|
|
| Trigger Keywords | 3+ | ✓ | ✓ |
|
|
| File Formatting | Markdown | ✓ | ✓ |
|
|
|
|
### Skill Size
|
|
|
|
- Each skill: < 500 lines (focused, maintainable)
|
|
- Frontmatter: 20-30 lines (JSON)
|
|
- Markdown content: 470-480 lines (description, examples, implementation notes)
|
|
|
|
## Naming Conventions
|
|
|
|
### Skill Names
|
|
- Format: `kebab-case` (hyphens only)
|
|
- Prefix: `ck-` (ClaudeKit namespace)
|
|
- Examples: `ck-code-review`, `ck-frontend-development`, `ck-ai-multimodal`
|
|
|
|
### Categories
|
|
- `ck-core` — Core workflow skills
|
|
- `ck-development` — Language/framework skills
|
|
- `ck-specialized` — Domain expertise skills
|
|
- `ck-guards` — Security and quality guards
|
|
- `ck-commands` — CLI commands
|
|
- `ck-agents` — Manager surfaces/agents
|
|
|
|
### Files
|
|
- Skills: `skills/{skill-name}/SKILL.md`
|
|
- Templates: `templates/SKILL.md`
|
|
- Docs: `docs/{topic}.md`
|
|
|
|
## Dependencies & Integrations
|
|
|
|
### External
|
|
- **Antigravity IDE (Gemini CLI)** v1.0+ — Required runtime
|
|
- No ClaudeKit IDE, no Task tool, no Hook system
|
|
|
|
### Internal
|
|
- Most skills are independent
|
|
- Utilities reused: `ck-help`, `ck-research`, `ck-git`
|
|
- Guard skills operate transparently (no direct dependencies)
|
|
- Commands invoke other skills as needed
|
|
|
|
## Installation & Distribution
|
|
|
|
### Package Contents
|
|
- 76 skill SKILL.md files
|
|
- 1 SKILL.md template for contributors
|
|
- Installation scripts (bash, PowerShell)
|
|
- skills_index.json registry
|
|
- Comprehensive documentation
|
|
|
|
### Installation
|
|
```bash
|
|
# Global (all projects)
|
|
./install.sh --global
|
|
# → ~/.gemini/antigravity/skills/
|
|
|
|
# Workspace (current project)
|
|
./install.sh --workspace
|
|
# → ./.agent/skills/
|
|
|
|
# Windows
|
|
.\install.ps1
|
|
```
|
|
|
|
## Documentation Structure
|
|
|
|
```
|
|
docs/
|
|
├── project-overview-pdr.md # Project PDR & vision
|
|
├── codebase-summary.md # Code structure (this file)
|
|
├── migration-guide-from-claudekit.md # How to migrate from old CK
|
|
├── project-changelog.md # Version history
|
|
└── skill-categories-guide.md # Detailed category reference
|
|
```
|
|
|
|
## Performance & Scalability
|
|
|
|
### Latency
|
|
- Skill invocation: < 100ms (excluding LLM)
|
|
- Frontmatter parsing: < 50ms per skill
|
|
- Full workflow: LLM-dependent (typically 2-10 minutes)
|
|
|
|
### Scalability
|
|
- Designed for teams of any size
|
|
- Handles projects from starter to enterprise
|
|
- Can be extended with custom skills
|
|
|
|
## Security & Privacy
|
|
|
|
### Data Handling
|
|
- Privacy guard prevents secret exposure
|
|
- Code stays local (not sent to external services)
|
|
- No telemetry or usage tracking
|
|
- Open-source (MIT license)
|
|
|
|
### Code Review
|
|
- Zero hardcoded credentials
|
|
- No shell execution (Antigravity IDE safe)
|
|
- Security-focused guard skills included
|
|
|
|
## Known Limitations
|
|
|
|
1. **No Task tool**: Skills invoke sequentially via user direction
|
|
2. **No Hooks**: Hard-gates replace hook system
|
|
3. **No Slash commands**: Semantic triggering instead
|
|
4. **Single IDE**: Requires Antigravity IDE v1.0+
|
|
5. **No real-time sync**: Docs/code are local files
|
|
|
|
## Future Enhancements (Out of Scope v1.0)
|
|
|
|
- Web dashboard for workflow visualization
|
|
- Real-time team collaboration
|
|
- GitHub/GitLab deep integration
|
|
- Custom skill plugins
|
|
- AI-powered code generation (Claude API)
|
|
- Multi-language support
|
|
|
|
## References
|
|
|
|
### Key Files
|
|
- **Skills Registry:** `skills_index.json`
|
|
- **README:** `README.md`
|
|
- **Changelog:** `CHANGELOG.md`
|
|
- **Installation:** `install.sh`, `install.ps1`
|
|
|
|
### Documentation
|
|
- Project PDR: `docs/project-overview-pdr.md`
|
|
- Migration Guide: `docs/migration-guide-from-claudekit.md`
|
|
- Changelog: `docs/project-changelog.md`
|
|
|
|
### External
|
|
- Antigravity IDE Documentation
|
|
- ClaudeKit Legacy Documentation (historical reference)
|
|
|
|
## Support & Contribution
|
|
|
|
### Getting Help
|
|
1. Run `ck-help` skill for context-aware assistance
|
|
2. Check GitHub README and migration guide
|
|
3. File GitHub issues with skill name and error details
|
|
|
|
### Contributing
|
|
1. Fork repository
|
|
2. Create skill in `skills/{skill-name}/SKILL.md`
|
|
3. Add entry to `skills_index.json`
|
|
4. Test with Antigravity IDE
|
|
5. Submit PR with description
|
|
|
|
## Version History
|
|
|
|
| Version | Date | Changes |
|
|
|---------|------|---------|
|
|
| 1.0.0 | 2026-02-16 | Initial release: 76 skills, complete workflow |
|
|
|
|
## Project Metadata
|
|
|
|
- **Repository:** `antigravity-claudekit`
|
|
- **Language:** Markdown + JSON (skill definitions)
|
|
- **License:** MIT
|
|
- **Status:** Production Ready
|
|
- **Original:** ClaudeKit AI Development Framework
|
|
- **Migration:** To Antigravity IDE ecosystem
|