deepseek-ai/deepseek-harness · error

skill file ${path} ignored: invalid invocation frontmatter:

Error message

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

What it means

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

Source

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

  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 {
    invocation = parseInvocationPolicy(parsed.data)
  } catch (error) {
    ctx.logger.warn(`skill file ${path} ignored: invalid invocation frontmatter: ${errorMessage(error)}`)
    return undefined
  }
  return {
    name,
    description,
    ...optionalString(parsed.data, 'whenToUse'),
    invocation,
    ...optionalMetadata(parsed.data),
    content: parsed.body.trim(),
  }
}

function optionalFileSystem(ctx: Context): FileSystem | undefined {
  return ctx.get('fs')
}

async function readSkillText(ctx: Context, path: string, signal?: AbortSignal, trustedHost = false): Promise<string | undefined> {
  signal?.throwIfAborted()

View on GitHub (pinned to b150a551b8)

Solutions

1. Fix the invocation frontmatter fields in the named skill file; the file is ignored until fixed.

When it happens

Trigger: Thrown at packages/skill/skill-filesystem/src/index.ts:824 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/a6953c8f7ada9a12. Report an issue: GitHub.