Fission-AI/OpenSpec · error

Tool ' ' does not support skill generation.

Error message

Tool '${tool.value}' does not support skill generation.

What it means

Sentinel guard in resolveToolSkillsDir: the given tool configuration has neither globalSkillsDir nor skillsDir, so there is no directory into which skills could be generated for that tool. The tool entry itself lacks the required skill-target fields — this is a configuration gap, not a filesystem problem.

Solutions

1. Use a tool that supports skill generation (one with a skillsDir configured)
2. Add a skillsDir or globalSkillsDir to the tool's configuration
3. Skip skill generation for tools that only support instructions/output styles

When it happens

Trigger: Thrown at src/core/shared/skill-paths.ts:37 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Fission-AI/OpenSpec@6926ccb18a (2026-08-25). Data as JSON: /api/errors/ba429cbc278426a2. Report an issue: GitHub.

Appendix: source

Thrown at src/core/shared/skill-paths.ts:37

export function hasGlobalSkillTarget(tool: AIToolOption): boolean {
  return Boolean(tool.globalSkillsDir);
}

export function resolveToolSkillsDir(
  projectRoot: string,
  tool: SkillCapableTool,
  options: { homeDir?: string } = {}
): string {
  if (tool.globalSkillsDir) {
    const homeDir = options.homeDir ?? process.env.USERPROFILE ?? process.env.HOME ?? os.homedir();
    return path.join(homeDir, tool.globalSkillsDir, 'skills');
  }

  if (tool.skillsDir) {
    return path.join(projectRoot, tool.skillsDir, 'skills');
  }

  throw new Error(`Tool '${tool.value}' does not support skill generation.`);
}

View on GitHub (pinned to 6926ccb18a)