Skip to main content

Skills

Skills are structured workflow instructions that AI agents must follow. They enforce consistent processes for common development tasks.

All skills now use the / prefix (e.g., /test-driven-development)

Why Skills?

Without skills, AI agents may:

  • Skip important steps (like writing tests)
  • Use inconsistent approaches for similar tasks
  • Not follow best practices
  • Make avoidable mistakes

With skills, AI agents:

  • Follow proven workflows step-by-step
  • Don't skip important steps
  • Apply best practices automatically
  • Produce more consistent, reliable code

How to Use Skills

Find Skills

# Find skills matching a topic
> find_skills("test")
> find_skills("debug")
> find_skills("react")

Use Skills (OpenCode)

# Direct invocation with prefix
/test-driven-development

# Or via tool
> use_skill("test-driven-development")
> Implement user authentication

CLI

# List all skills
aikit skills list

# Show skill details
aikit skills show test-driven-development

# Create custom skill
aikit skills create my-custom-skill

All Skills

AIKit includes 22 built-in skills organized into 11 categories:

CategorySkillDescription
DebuggingSystematic DebuggingStructured debugging workflow
Design & UIAccessibilityWCAG compliance and a11y guidelines
Design & UIAnimationCSS animations and transitions
Design & UIDesign MeasurementDesign metrics and analysis
Design & UIFrontend AestheticsUI design principles
Design & UIShadcn UIShadcn UI component patterns
Design & UITailwind CSSTailwind CSS utility-first framework
DevelopmentAPI DesignREST API design best practices
DevelopmentComponent DesignReact/Vue component patterns
DevelopmentState ManagementApplication state patterns
DevelopmentError HandlingException handling patterns
DevelopmentRefactoringCode restructuring with tests
DevelopmentPerformance OptimizationFrontend performance
DevelopmentAdvanced ReactAdvanced React patterns
DevelopmentNext.jsNext.js framework best practices
DevelopmentBackend DevelopmentServer-side development
DevelopmentMobile DevelopmentMobile app development
DocumentationDocumentationTechnical documentation best practices
FigmaAnalyze FigmaExtract design tokens from Figma
FigmaFigma to CodeConvert Figma designs to code
GitGit Best PracticesGit conventions and guidelines
GitGit WorkflowBranching strategies and workflows
MetaUsing SuperpowersHow to use skills system
MetaWriting PlansImplementation planning
PlatformsPaymentsPayment integration patterns
PlatformsShopifyShopify development
ReviewCode ReviewCode quality review
ReviewSecurity AuditSecurity vulnerability scanning
TestingIntegration TestingTest component interactions
TestingTest-Driven DevelopmentTDD workflow (RED → GREEN → REFACTOR)
TestingUnit TestingTest individual functions/components
TestingTesting FrontendFrontend testing strategies
ToolsDockerContainerization with Docker
ToolsKubernetesK orchestration and deployment
ToolsCI/CDContinuous integration and deployment
ToolsAI MultimodalMulti-modal AI capabilities
ToolsGemini VisionGoogle Gemini vision API
ToolsMCP BuilderModel Context Protocol builder
ToolsChrome DevToolsBrowser debugging tools
ToolsThree.js3D graphics with Three.js
ToolsGoogle ADK PythonGoogle Agent Development Kit for Python

By Category

CategoryCountSkills
Debugging1Systematic Debugging
Design3Accessibility, Database Design, Frontend Aesthetics
Development4API Design, Component Design, Performance Optimization, State Management
Documentation1Documentation
Figma2Analyze Figma, Figma to Code
Git1Git Workflow
Meta2Using Superpowers, Writing Plans
Review2Code Review, Security Audit
Testing3Integration Testing, Test-Driven Development, Unit Testing
Tools0(See tools documentation)
Total22All built-in skills

Skill Format

Each skill has:

---
name: skill-name
description: What this skill does
useWhen: When to use this skill
category: Category name
tags:
  - tag1
  - tag2
---

## Workflow

Step-by-step instructions...

## Checklist

- [ ] Step 1
- [ ] Step 2
- [ ] Step 3

Custom Skills

Create project-specific skills:

aikit skills create my-workflow

Edit .aikit/skills/my-workflow.md with your workflow.

Sync Skills

Sync global skills to project:

aikit skills sync

Most commonly used skills:

  1. Test-Driven Development - TDD workflow
  2. Systematic Debugging - Debug workflow
  3. Code Review - Review workflow
  4. Refactoring - Refactor workflow
  5. API Design - API design
  6. Component Design - Component design
  7. Accessibility - A11y guidelines
  8. Performance Optimization - Performance
  9. Security Audit - Security
  10. Documentation - Documentation

Next Steps