davila7/claude-code-templates · warning

Warning: Error scanning skill directory ${skillPath}

Error message

Warning: Error scanning skill directory ${skillPath}

What it means

scanSupportingFiles catches any error thrown while recursively walking a skill directory and returns whatever files were collected so far. It means the directory walk (readdir/stat on entries) failed partway through.

Source

Thrown at cli-tool/src/skill-dashboard.js:254

            files.push({
              name: entry,
              path: fullPath,
              relativePath: relPath,
              size: stat.size,
              isDirectory: false,
              type: self.getFileType(entry) // Use self instead of this
            });
          }
        } catch (error) {
          // Skip files we can't read
        }
      }
    }

    try {
      await scanDirectory(skillPath);
    } catch (error) {
      console.warn(chalk.yellow(`Warning: Error scanning skill directory ${skillPath}`), error.message);
    }

    return files;
  }

  categorizeFiles(files, markdownContent) {
    const categorized = {
      alwaysLoaded: ['SKILL.md'],
      onDemand: [],
      progressive: []
    };

    // Parse referenced files from markdown content
    const referencedFiles = this.extractReferencedFiles(markdownContent);

    for (const file of files) {
      const ext = path.extname(file.name).toLowerCase();

View on GitHub (pinned to a0851ed10c)

Solutions

  1. Check permissions on the skill directory tree (ls -la, chmod -R)
  2. Remove broken symlinks or stale temp files inside the skill folder
  3. Re-run the scan when no other process is writing to the folder
Defensive patterns

Strategy: fallback

Validate before calling

const ok = await fs.pathExists(skillPath).catch(() => false);
if (!ok) return [];

Prevention

When it happens

Trigger: A subdirectory or file inside the skill folder is deleted mid-scan, has restrictive permissions, is a broken symlink, or readdir fails on a deeply nested path (EMOULINK/ENOENT/EACCES).

Common situations: Editor or sync tool modifying the skill folder during scan; read-only mounts; broken symlinks in skill assets.

Related errors


AI-assisted analysis of davila7/claude-code-templates@a0851ed10c (2026-08-28). Data as JSON: /api/errors/376e5634536baa18. Report an issue: GitHub.