skill file ${path} ignored: invalid YAML frontmatter: ${erro

Error message

skill file ${path} ignored: invalid YAML frontmatter: ${errorMessage(error)}

What it means

Error "skill file ${path} ignored: invalid YAML frontmatter: ${errorMessage(error)}" thrown in deepseek-ai/deepseek-harness.

Source

Thrown at packages/skill/skill-filesystem/src/index.ts:803

  for (const entry of entries) {
    const path = join(root.path, entry.name)
    const type = await nodeEntryKind(path, entry, ctx)
    result.push({ name: entry.name, type: type ?? 'other', path })
  }
  return result
}

async function parseSkillFile(path: string, ctx: Context, signal?: AbortSignal, trustedHost = false): Promise<ParsedSkill | undefined> {
  const raw = await readSkillText(ctx, path, signal, trustedHost)
  signal?.throwIfAborted()
  if (raw === undefined) {
    return undefined
  }
  let parsed
  try {
    parsed = parseFrontmatter(raw)
  } catch (error) {
    ctx.logger.warn(`skill file ${path} ignored: invalid YAML frontmatter: ${errorMessage(error)}`)
    return undefined
  }
  if (!parsed) {
    ctx.logger.warn(`skill file ${path} ignored: missing YAML frontmatter`)
    return undefined
  }
  const name = stringField(parsed.data, 'name')
  const description = stringField(parsed.data, 'description')
  if (name === undefined || description === undefined) {
    ctx.logger.warn(`skill file ${path} ignored: frontmatter requires name and description`)
    return undefined
  }
  if (!isSkillName(name)) {
    ctx.logger.warn(`skill file ${path} ignored: invalid skill name "${name}"`)
    return undefined
  }
  let invocation
  try {

View on GitHub (pinned to b150a551b8)

Solutions

Fix the YAML frontmatter in the named skill file so it parses; the file is ignored until fixed.

When it happens

Trigger: Thrown at packages/skill/skill-filesystem/src/index.ts:803 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of deepseek-ai/deepseek-harness@b150a551b8 (2026-08-24). Data as JSON: /api/errors/8257a0eba1053a3f. Report an issue: GitHub.