OthmanAdi
0ec48c1c13
installation.md now states what each install route actually ships (the plugin route carries commands/ and reliable hook registration; npx skills and manual copies do not), documents the project-trust gate that silently disables project-level skills, and offers a one-line CLAUDE.md trigger snippet: the July 2026 benchmark measured unforced skill engagement at 60-67% while always-loaded rules lines engaged 100%. The last two variant copies still teaching Manus-2025 "one tool call per turn" (.factory, .mastracode) get the 2026 parallel-host update the canonical reference.md already carries. kilocode.md notes the Windsurf to Devin Desktop transition.
6.1 KiB
6.1 KiB
Kilo Code Support
Planning with Files is fully supported on Kilo Code through native integration.
Quick Start
- Open your project in Kilo Code
- Skills load automatically from global (
~/.kilocode/skills/) or project (.kilocode/skills/) directories - Start a complex task — Kilo Code will automatically create planning files
Installation
Quick Install (Project-Level)
Clone or copy the skill to your project's .kilocode/skills/ directory:
Unix/Linux/macOS:
# Option A: Clone the repository
git clone https://github.com/OthmanAdi/planning-with-files.git
# Copy the skill to Kilo Code's skills directory
mkdir -p .kilocode/skills
cp -r planning-with-files/skills/planning-with-files .kilocode/skills/
Windows (PowerShell):
# Option A: Clone the repository
git clone https://github.com/OthmanAdi/planning-with-files.git
# Copy the skill to Kilo Code's skills directory
New-Item -ItemType Directory -Force -Path .kilocode\skills
Copy-Item -Recurse -Force planning-with-files\skills\planning-with-files .kilocode\skills\
Manual Installation (Project-Level)
Copy the skill directory to your project:
Unix/Linux/macOS:
# From the cloned repository
mkdir -p .kilocode/skills
cp -r planning-with-files/skills/planning-with-files .kilocode/skills/
Windows (PowerShell):
# From the cloned repository
New-Item -ItemType Directory -Force -Path .kilocode\skills
Copy-Item -Recurse -Force planning-with-files\skills\planning-with-files .kilocode\skills\
Global Installation (User-Level)
To make the skill available across all projects:
Unix/Linux/macOS:
# Copy to global skills directory
mkdir -p ~/.kilocode/skills
cp -r planning-with-files/skills/planning-with-files ~/.kilocode/skills/
Windows (PowerShell):
# Copy to global skills directory (replace YourUsername with your actual username)
New-Item -ItemType Directory -Force -Path C:\Users\YourUsername\.kilocode\skills
Copy-Item -Recurse -Force planning-with-files\skills\planning-with-files C:\Users\YourUsername\.kilocode\skills\
Verifying Installation
After installation, verify the skill is loaded:
- Restart Kilo Code (if needed)
- Ask the agent: "Do you have access to the planning-with-files skill?"
- The agent should confirm the skill is loaded
Testing PowerShell Scripts (Windows):
After installation, you can test the PowerShell scripts:
# Test init-session.ps1
.\.kilocode\skills\planning-with-files\scripts\init-session.ps1
# Test check-complete.ps1
.\.kilocode\skills\planning-with-files\scripts\check-complete.ps1
The scripts should create task_plan.md, findings.md, and progress.md files in your project root.
File Structure
~/.kilocode/skills/planning-with-files/ (Global)
OR
.kilocode/skills/planning-with-files/ (Project)
├── SKILL.md # Skill definition
├── examples.md # Real-world examples
├── reference.md # Advanced reference
├── templates/ # Planning file templates
│ ├── task_plan.md
│ ├── findings.md
│ └── progress.md
└── scripts/ # Utility scripts
├── init-session.sh # Unix/Linux/macOS
├── check-complete.sh # Unix/Linux/macOS
├── init-session.ps1 # Windows (PowerShell)
└── check-complete.ps1 # Windows (PowerShell)
Important: The name field in SKILL.md must match the directory name (planning-with-files).
File Locations
| Type | Global Location | Project Location |
|---|---|---|
| Skill | ~/.kilocode/skills/planning-with-files/SKILL.md |
.kilocode/skills/planning-with-files/SKILL.md |
| Templates | ~/.kilocode/skills/planning-with-files/templates/ |
.kilocode/skills/planning-with-files/templates/ |
| Scripts (Unix/Linux/macOS) | ~/.kilocode/skills/planning-with-files/scripts/*.sh |
.kilocode/skills/planning-with-files/scripts/*.sh |
| Scripts (Windows PowerShell) | ~/.kilocode/skills/planning-with-files/scripts/*.ps1 |
.kilocode/skills/planning-with-files/scripts/*.ps1 |
| Your Files | task_plan.md, findings.md, progress.md in project root |
Quick Commands
For Global Installation:
Unix/Linux/macOS:
# Initialize planning files
~/.kilocode/skills/planning-with-files/scripts/init-session.sh
# Verify task completion
~/.kilocode/skills/planning-with-files/scripts/check-complete.sh
Windows (PowerShell):
# Initialize planning files
$env:USERPROFILE\.kilocode\skills\planning-with-files\scripts\init-session.ps1
# Verify task completion
$env:USERPROFILE\.kilocode\skills\planning-with-files\scripts\check-complete.ps1
For Project Installation:
Unix/Linux/macOS:
# Initialize planning files
./.kilocode/skills/planning-with-files/scripts/init-session.sh
# Verify task completion
./.kilocode/skills/planning-with-files/scripts/check-complete.sh
Windows (PowerShell):
# Initialize planning files
.\.kilocode\skills\planning-with-files\scripts\init-session.ps1
# Verify task completion
.\.kilocode\skills\planning-with-files\scripts\check-complete.ps1
Migrating from Cursor/Windsurf (Windsurf became Devin Desktop in June 2026)
Planning files are fully compatible. Simply copy your task_plan.md, findings.md, and progress.md files to your new project.
Additional Resources
For Global Installation:
- Examples - Real-world examples
- Reference - Advanced reference documentation
- PowerShell Scripts - Utility scripts for Windows
For Project Installation:
- Examples - Real-world examples
- Reference - Advanced reference documentation
- PowerShell Scripts - Utility scripts for Windows