---
project: "kodi-agent"
updated: "2026-04-12"
total_files: 51
total_dirs: 24
---

# KodiAgent — Directory Structure

```
.agent/
├── rules/                              # Behavioral rules (13 files)
│   ├── agent-structure.md              # .agent/ folder structure reference
│   ├── bug-diagnosis.md                # Bug diagnosis methodology
│   ├── docs-first.md                   # Documentation-first approach
│   ├── file-protection.md              # File protection safety rules
│   ├── general.md                      # Core agent identity and paths
│   ├── hosting.md                      # Hosting server SSH access
│   ├── issues.md                       # Issue management and status protection
│   ├── kodi-development.md             # Kodi addon development constraints
│   ├── kodi.md                         # Kodi management paths and safety
│   ├── os-detection.md                 # OS detection and adaptation
│   ├── planning.md                     # Planning system rules
│   ├── self-improve.md                 # Self-improvement triggers
│   └── shell-safety.md                 # Shell command safety rules
│
├── skills/                             # Domain knowledge (20 skills)
│   ├── agent-customization/SKILL.md    # Creating/managing .agent/ components
│   ├── issue-management/SKILL.md       # Issue file lifecycle
│   ├── kodi-addon-runtime/SKILL.md     # Plugin statelessness, service lifecycle
│   ├── kodi-addons/SKILL.md            # Addon install/remove/update
│   ├── kodi-management/SKILL.md        # Kodi config, JSON-RPC, processes
│   ├── kodi-python-api/SKILL.md        # xbmc*, ListItem, InfoTagVideo API
│   ├── kodi-settings/SKILL.md          # settings.xml controls, visibility, eq()
│   ├── kodi-skinning-xml/SKILL.md      # XML dialogs, absolute positioning
│   ├── llm-xml-generation/SKILL.md     # AI-generated Kodi UI layouts
│   ├── macos-system/SKILL.md           # macOS diagnostics and management
│   ├── planning-system/SKILL.md        # Implementation plan methodology
│   ├── plugin-changelog/SKILL.md       # Version history conventions
│   ├── plugin-dependencies/SKILL.md    # External dependency tracking
│   ├── plugin-features/SKILL.md        # Feature documentation format
│   ├── plugin-overview/SKILL.md        # Plugin general context
│   ├── plugin-settings/SKILL.md        # Plugin settings reference
│   ├── plugin-structure/SKILL.md       # Plugin codebase navigation
│   ├── self-improve/SKILL.md           # Error analysis and config updates
│   ├── shell-commands/SKILL.md         # Advanced zsh scripting
│   └── system-audit/SKILL.md           # Comprehensive system auditor
│
├── workflows/                          # User-triggered commands (18 files)
│   ├── audit.md                        # /audit — system integrity check
│   ├── backup.md                       # /backup — Kodi state backup
│   ├── change-os.md                    # /change-os — OS adaptation
│   ├── create.md                       # /create — new rules/skills/workflows
│   ├── deploy.md                       # /deploy — package and upload addon
│   ├── do.md                           # /do — execute approved plan
│   ├── docs.md                         # /docs — project documentation
│   ├── explain.md                      # /explain — stop and explain
│   ├── features.md                     # /features — feature documentation
│   ├── help.md                         # /help — system overview
│   ├── improve.md                      # /improve — learn from errors
│   ├── install.md                      # /install — addon installation
│   ├── issue.md                        # /issue — bug recording
│   ├── learn.md                        # /learn — load feature knowledge
│   ├── plan.md                         # /plan — implementation planning
│   ├── research.md                     # /research — online research
│   ├── reset-kodi.md                   # /reset-kodi — factory reset
│   └── restore.md                      # /restore — restore from backup
│
docs/
├── features/                           # Project feature documentation
│   ├── kodi-agent/                     # This project's docs
│   └── plugin-video-milionar/          # Plugin docs (21 files)
├── issues/                             # Bug tracking per project
├── plans/                              # Implementation plans per project
└── research/                           # Online research results
```
