Skills
Skills are structured workflow instructions that AI agents must follow. They enforce consistent processes for common development tasks.
lightbulb All skills now use the /ak_sk_ prefix (e.g., /ak_sk_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("refactor")
Use Skills (OpenCode)
# Direct invocation with prefix
/ak_sk_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
Skills are organized into 9 categories for better discoverability:
Debugging (1 skill)
- Systematic Debugging - Structured debugging workflow
Design (4 skills)
- Accessibility - WCAG compliance and a11y guidelines
- Database Design - Schema design principles
- Design Measurement - Design metrics and analysis
- Frontend Aesthetics - UI design principles
Development (6 skills)
- API Design - REST API design best practices
- Component Design - React/Vue component patterns
- Error Handling - Exception handling patterns
- Performance Optimization - Frontend performance
- Refactoring - Code restructuring with tests
- State Management - Application state patterns
Documentation (1 skill)
- Documentation - Technical documentation best practices
Figma (2 skills)
- Analyze Figma - Extract design tokens from Figma
- Figma to Code - Convert Figma designs to code
Git (1 skill)
- Git Workflow - Best git practices and workflow
Meta (2 skills)
- Using Superpowers - How to use skills system
- Writing Plans - Implementation planning
Review (2 skills)
- Code Review - Code quality review
- Security Audit - Security vulnerability scanning
Testing (3 skills)
- Integration Testing - Test component interactions
- Test-Driven Development - TDD workflow (RED → GREEN → REFACTOR)
- Unit Testing - Test individual functions/components
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