Release v0.20.0

packages/coding-agent/CHANGELOG.md

@@ -1,12 +1,6 @@
 # Changelog
 
-## [0.19.1] - 2025-12-12
-
-### Fixed
-
-- Documentation: Added skills system documentation to README (setup, usage, CLI flags, settings)
-
-## [Unreleased]
+## [0.20.0] - 2025-12-13
 
 ### Breaking Changes
 
@@ -16,6 +10,12 @@
 
 - Display loaded skills on startup in interactive mode
 
+## [0.19.1] - 2025-12-12
+
+### Fixed
+
+- Documentation: Added skills system documentation to README (setup, usage, CLI flags, settings)
+
 ## [0.19.0] - 2025-12-12
 
 ### Added

packages/coding-agent/README.md

@@ -470,14 +470,16 @@ Usage: `/component Button "onClick handler" "disabled support"`
 Skills are instruction files loaded on-demand when tasks match their descriptions. Compatible with Claude Code and Codex CLI skill formats.
 
 **Skill locations:**
-- Pi user: `~/.pi/agent/skills/**/*.md` (recursive)
-- Pi project: `.pi/skills/**/*.md` (recursive)
+- Pi user: `~/.pi/agent/skills/**/SKILL.md` (recursive, colon-separated names)
+- Pi project: `.pi/skills/**/SKILL.md` (recursive, colon-separated names)
 - Claude Code user: `~/.claude/skills/*/SKILL.md` (one level)
 - Claude Code project: `.claude/skills/*/SKILL.md` (one level)
 - Codex CLI: `~/.codex/skills/**/SKILL.md` (recursive)
 
 Later locations win on name collisions (Pi skills override Claude/Codex).
 
+Pi skills in subdirectories use colon-separated names: `~/.pi/agent/skills/db/migrate/SKILL.md` → `db:migrate`
+
 **Format:**
 
 ```markdown
@@ -494,8 +496,8 @@ Helper scripts: {baseDir}/scripts/
 ```
 
 - `description`: Required. Shown in system prompt for agent to decide when to load.
-- `name`: Optional. Overrides filename/directory name.
-- `{baseDir}`: Replaced with skill's directory path.
+- `name`: Optional. Overrides directory name.
+- `{baseDir}`: Placeholder for the skill's directory. Agent substitutes it when following instructions.
 
 **How it works:**
 
@@ -504,8 +506,8 @@ Skills are listed in the system prompt with descriptions:
 ```
 <available_skills>
 - pdf-extract: Extract text and tables from PDF files
-  File: ~/.pi/agent/skills/pdf-extract.md
-  Base directory: ~/.pi/agent/skills
+  File: ~/.pi/agent/skills/pdf-extract/SKILL.md
+  Base directory: ~/.pi/agent/skills/pdf-extract
 </available_skills>
 ```
 

packages/coding-agent/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mariozechner/pi-coding-agent",
-	"version": "0.19.2",
+	"version": "0.20.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -39,9 +39,9 @@
 		"prepublishOnly": "npm run clean && npm run build"
 	},
 	"dependencies": {
-		"@mariozechner/pi-agent-core": "^0.19.2",
-		"@mariozechner/pi-ai": "^0.19.2",
-		"@mariozechner/pi-tui": "^0.19.2",
+		"@mariozechner/pi-agent-core": "^0.20.0",
+		"@mariozechner/pi-ai": "^0.20.0",
+		"@mariozechner/pi-tui": "^0.20.0",
 		"chalk": "^5.5.0",
 		"diff": "^8.0.2",
 		"glob": "^11.0.3",