Fix symlinked skill directories not being discovered

Release v0.27.4

packages/coding-agent/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.27.4] - 2025-12-24
+
+### Fixed
+
+- **Symlinked skill directories**: Skills in symlinked directories (e.g., `~/.pi/agent/skills/my-skills -> /path/to/skills`) are now correctly discovered and loaded.
+
 ## [0.27.3] - 2025-12-24
 
 ### Added

packages/coding-agent/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mariozechner/pi-coding-agent",
-	"version": "0.27.3",
+	"version": "0.27.4",
 	"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.27.3",
-		"@mariozechner/pi-ai": "^0.27.3",
-		"@mariozechner/pi-tui": "^0.27.3",
+		"@mariozechner/pi-agent-core": "^0.27.4",
+		"@mariozechner/pi-ai": "^0.27.4",
+		"@mariozechner/pi-tui": "^0.27.4",
 		"chalk": "^5.5.0",
 		"cli-highlight": "^2.1.11",
 		"diff": "^8.0.2",

packages/coding-agent/src/core/skills.ts

@@ -1,4 +1,4 @@
-import { existsSync, readdirSync, readFileSync } from "fs";
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
 import { minimatch } from "minimatch";
 import { homedir } from "os";
 import { basename, dirname, join, resolve } from "path";
@@ -187,19 +187,29 @@ function loadSkillsFromDirInternal(dir: string, source: string, format: SkillFor
 				continue;
 			}
 
-			if (entry.isSymbolicLink()) {
-				continue;
-			}
-
 			const fullPath = join(dir, entry.name);
 
+			// For symlinks, check if they point to a directory and follow them
+			let isDirectory = entry.isDirectory();
+			let isFile = entry.isFile();
+			if (entry.isSymbolicLink()) {
+				try {
+					const stats = statSync(fullPath);
+					isDirectory = stats.isDirectory();
+					isFile = stats.isFile();
+				} catch {
+					// Broken symlink, skip it
+					continue;
+				}
+			}
+
 			if (format === "recursive") {
 				// Recursive format: scan directories, look for SKILL.md files
-				if (entry.isDirectory()) {
+				if (isDirectory) {
 					const subResult = loadSkillsFromDirInternal(fullPath, source, format);
 					skills.push(...subResult.skills);
 					warnings.push(...subResult.warnings);
-				} else if (entry.isFile() && entry.name === "SKILL.md") {
+				} else if (isFile && entry.name === "SKILL.md") {
 					const result = loadSkillFromFile(fullPath, source);
 					if (result.skill) {
 						skills.push(result.skill);
@@ -208,7 +218,7 @@ function loadSkillsFromDirInternal(dir: string, source: string, format: SkillFor
 				}
 			} else if (format === "claude") {
 				// Claude format: only one level deep, each directory must contain SKILL.md
-				if (!entry.isDirectory()) {
+				if (!isDirectory) {
 					continue;
 				}