Kiloconfig

Comprehensive skills configuration for Kilo Code VSCode, optimized for professional Python development.

Purpose

Kiloconfig is a set of AI skills for Kilo Code, integrating best practices from:

• OpenCode — code quality, documentation, and testing standards
• OhMyOpenCode — specialized agents (Oracle, Librarian, Explore)
• Python Best Practices — performance patterns, async/await, pytest

Key Features

• 14 specialized skills for Python development
• Automatic code validation (PEP 8, type hints, docstrings)
• Integration with MCP servers for enhanced search
• Cross-platform installers (Windows, macOS, Linux)
• Automated project structure tests

Potential Benefits

• Faster Development — automation of routine checks and code standardization
• Higher Quality — adherence to PEP 8, type hints, pytest best practices
• Token Savings — using GLM-4.7 for most tasks instead of expensive models
• Consistency — unified documentation and testing standards

Requirements

• VS Code with Kilo Code plugin installed
• Python 3.10+ (for running tests)
• uv (recommended for Python management)

Installation

Quick Start (Windows)

# Clone repository
git clone <repo-url> kiloconfig
cd kiloconfig

# Run installer
.\install.ps1

Quick Start (macOS/Linux)

# Clone repository
git clone <repo-url> kiloconfig
cd kiloconfig

# Run installer
chmod +x install.sh
./install.sh

Installer Options

Windows (PowerShell)

.\install.ps1                                    # Standard installation
.\install.ps1 -TargetPath "C:\custom\.kilocode"  # Custom path
.\install.ps1 -Force                             # Without confirmation
.\install.ps1 -Backup:$false                     # No backup

macOS/Linux (Bash)

./install.sh                          # Standard installation
./install.sh --target ~/.kilocode     # Custom path
./install.sh --force                  # Without confirmation
./install.sh --no-backup              # No backup

Installer Features

• Smart Merge — updates files without overwriting user changes
• Automatic Backup — creates timestamped backup
• File Preservation — doesn't touch *.local.*, *.user.*, custom_*, my_*
• Validation — checks SKILL.md for YAML correctness

Manual Installation

# Windows
$target = "$env:USERPROFILE\.kilocode"
Copy-Item -Path ".\.kilocode\*" -Destination $target -Recurse -Force

# macOS/Linux
cp -r .kilocode/* ~/.kilocode/

After Installation

1. Import Custom Modes

VS Code → Prompts Tab → Import Mode (upload icon)
→ Select .kilocode/custom_modes.yaml
→ Select "Global" (for all projects)

After importing, 6 new modes will appear:

• 🎯 Oracle
• 🔧 Backend Developer
• 🎨 Frontend Developer
• 🧪 Test Engineer
• 👁️ Code Reviewer
• 🔍 Explore

2. Reload VS Code

Ctrl+Shift+P → "Developer: Reload Window"

3. Check Modes

New modes should appear in mode selector. Select Oracle mode for task orchestration.

Installed Skills

Generic Skills (all modes) — 12 skills

Skill	Description
code-quality-standards	Python quality standards (PEP 8, type hints)
documentation-standards	Python documentation (PEP 257, Google style)
test-coverage-standards	Pytest best practices and coverage
python-performance	Performance optimization
python-async	Async/await patterns
python-testing	Pytest workflows and integration tests
librarian	Documentation and code search
ralph-loop	Self-referential development cycle
verification	Checks before completion
openagent-workflows	6-stage development workflow
agent-browser	Browser automation
fastapi	FastAPI patterns and templates

Custom Modes — 6 modes

Mode	Description
🎯 Oracle	Orchestrator — delegates tasks to other agents
🔧 Backend Developer	Backend API, databases, microservices
🎨 Frontend Developer	UI/UX, React/Vue, TypeScript
🧪 Test Engineer	Tests, pytest, coverage
👁️ Code Reviewer	Code review, security
🔍 Explore	Fast codebase search

Important: Custom Modes are independent of Generic Skills. They are configured via custom_modes.yaml and imported into Kilo Code.

Testing

Running Tests

# Install dependencies and run tests
uv sync
uv run pytest

# With verbose output
uv run pytest -v

# Specific test
uv run pytest tests/test_structure.py::TestSkillFiles -v

Test Structure

tests/
├── conftest.py          # Pytest fixtures
├── test_structure.py    # 26 validation tests
└── requirements.txt     # Test dependencies

What Tests Check

• Directory Structure — presence of all required folders
• SKILL.md Files — YAML frontmatter, required fields, versions
• MCP Configuration — JSON validity, required fields
• Installers — presence and version correctness
• Documentation — presence of README, SKILLS.md
• Skill Count — matches expected count

Development

Project Structure

kiloconfig/
├── .kilocode/
│   ├── skills/              # Generic skills (12)
│   │   ├── code-quality-standards/
│   │   ├── documentation-standards/
│   │   ├── ...
│   │   └── fastapi/
│   ├── skills-code/         # Code mode skills (6)
│   │   ├── oracle/
│   │   ├── backend-developer/
│   │   ├── frontend-developer/
│   │   ├── test-engineer/
│   │   ├── code-reviewer/
│   │   └── explore/
│   ├── mcp/
│   │   └── server-list.json # MCP configuration
│   └── custom_modes.yaml    # Custom modes (import via UI)
├── tests/                   # Automated tests
├── install.ps1              # Windows PowerShell installer
├── install.bat              # Windows Batch installer
├── install.sh               # macOS/Linux installer
├── pyproject.toml           # Project configuration
├── SKILLS.md                # Skills index
├── task.md                  # Project specification
└── README.md                # This file

Creating a New Skill

1. Create directory in .kilocode/skills/<skill-name>/
2. Create SKILL.md file with YAML frontmatter:

---
name: my-new-skill
description: Description of what this skill does
version: 1.0.0
---

# My New Skill

Content of the skill...

3. Update tests in tests/test_structure.py
4. Run tests: uv run pytest
5. Update SKILLS.md

SKILL.md Requirements

• YAML frontmatter with --- at start and end
• Required fields: name, description, version
• name must match directory name
• Version in semver format: X.Y.Z
• Content after frontmatter > 100 characters

MCP Configuration

File .kilocode/mcp/server-list.json contains MCP server settings:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-name"],
      "enabled": true
    }
  }
}

Running Linters (Optional)

# Check formatting
uv run black --check .

# Type checking
uv run mypy tests/

Troubleshooting

Skills Not Loading

1. Check structure: each skill in <skill-name>/SKILL.md
2. Check YAML frontmatter: name and description are required
3. Reload VS Code: Ctrl+Shift+P → "Developer: Reload Window"
4. Check Kilo Code Output panel for errors

MCP Not Working

1. Check ~/.kilocode/mcp/server-list.json
2. Install MCP servers: npm install -g @anthropic/mcp-server-*
3. Set API keys (e.g., EXA_API_KEY for websearch)

Tests Failing

# Check structure
uv run pytest tests/test_structure.py::TestDirectoryStructure -v

# Check skill files
uv run pytest tests/test_structure.py::TestSkillFiles -v

Resources

• Kilo Code Documentation
• Agent Skills Specification
• Model Context Protocol
• Python PEP Index

License

MIT

---

Version: 1.0.0 Last Updated: 2026-01-24