vercel/ai · error · Error

Invalid ACP skill file path ${JSON.stringify(file.path)} for

Error message

Invalid ACP skill file path ${JSON.stringify(file.path)} for skill ${JSON.stringify(skill.name)}: SKILL.md is reserved for the skill definition.

What it means

Error "Invalid ACP skill file path ${JSON.stringify(file.path)} for skill ${JSON.stringify(skill.name)}: SKILL.md is reserved for the skill definition." thrown in vercel/ai.

Source

Thrown at packages/harness-acp/src/v1/acp-v1-skills.ts:128

      throw new Error(
        `Invalid ACP skill name ${JSON.stringify(skill.name)}: expected a kebab-case slug.`,
      );
    }
    if (skillNames.has(skill.name)) {
      throw new Error(
        `Duplicate ACP skill name ${JSON.stringify(skill.name)}.`,
      );
    }
    skillNames.add(skill.name);

    const filePaths = new Set<string>();
    for (const file of skill.files ?? []) {
      const normalizedPath = validateACPAttachedFilePath({
        skillName: skill.name,
        filePath: file.path,
      });
      if (normalizedPath === 'SKILL.md') {
        throw new Error(
          `Invalid ACP skill file path ${JSON.stringify(file.path)} for skill ${JSON.stringify(
            skill.name,
          )}: SKILL.md is reserved for the skill definition.`,
        );
      }
      if (filePaths.has(normalizedPath)) {
        throw new Error(
          `Duplicate ACP skill file path ${JSON.stringify(file.path)} for skill ${JSON.stringify(
            skill.name,
          )}.`,
        );
      }
      filePaths.add(normalizedPath);
    }
  }
}

function validateACPAttachedFilePath({

View on GitHub (pinned to 69428b1f8b)

When it happens

Trigger: Thrown at packages/harness-acp/src/v1/acp-v1-skills.ts:128 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of vercel/ai@69428b1f8b (2026-08-30). Data as JSON: /api/errors/828f61d043610ca9. Report an issue: GitHub.