{"record":{"id":"828f61d043610ca9","repo":"vercel/ai","slug":"invalid-acp-skill-file-path-json-stringify-file","errorCode":null,"errorMessage":"Invalid ACP skill file path ${JSON.stringify(file.path)} for skill ${JSON.stringify(skill.name)}: SKILL.md is reserved for the skill definition.","messagePattern":"Invalid ACP skill file path (.+?) for skill (.+?): SKILL\\.md is reserved for the skill definition\\.","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/harness-acp/src/v1/acp-v1-skills.ts","lineNumber":128,"sourceCode":"      throw new Error(\n        `Invalid ACP skill name ${JSON.stringify(skill.name)}: expected a kebab-case slug.`,\n      );\n    }\n    if (skillNames.has(skill.name)) {\n      throw new Error(\n        `Duplicate ACP skill name ${JSON.stringify(skill.name)}.`,\n      );\n    }\n    skillNames.add(skill.name);\n\n    const filePaths = new Set<string>();\n    for (const file of skill.files ?? []) {\n      const normalizedPath = validateACPAttachedFilePath({\n        skillName: skill.name,\n        filePath: file.path,\n      });\n      if (normalizedPath === 'SKILL.md') {\n        throw new Error(\n          `Invalid ACP skill file path ${JSON.stringify(file.path)} for skill ${JSON.stringify(\n            skill.name,\n          )}: SKILL.md is reserved for the skill definition.`,\n        );\n      }\n      if (filePaths.has(normalizedPath)) {\n        throw new Error(\n          `Duplicate ACP skill file path ${JSON.stringify(file.path)} for skill ${JSON.stringify(\n            skill.name,\n          )}.`,\n        );\n      }\n      filePaths.add(normalizedPath);\n    }\n  }\n}\n\nfunction validateACPAttachedFilePath({","sourceCodeStart":110,"sourceCodeEnd":146,"githubUrl":"https://github.com/vercel/ai/blob/69428b1f8b037e4d118fb4853428d5c4e620493c/packages/harness-acp/src/v1/acp-v1-skills.ts#L110-L146","documentation":"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.","triggerScenarios":"Thrown at packages/harness-acp/src/v1/acp-v1-skills.ts:128 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"69428b1f8b037e4d118fb4853428d5c4e620493c","analyzedAt":"2026-08-30T12:32:21.016Z","schemaVersion":2},"datasetVersion":"2026-08-30T13:17:10.514Z"}