Skip to content

skills/UPSTREAM-CREDITS.md trips pi-coding-agent skill loader ("description is required") #447

@tdietert

Description

@tdietert

Summary

When context-mode is installed globally and used with pi-coding-agent, pi prints a startup warning:

~/.npm-global/lib/node_modules/context-mode/skills/UPSTREAM-CREDITS.md
  description is required

Cause

Pi's skill discovery rules:

  • A directory containing SKILL.md is a skill root.
  • For top-level skill directories (including those declared via pi.skills in package.json), direct .md children at the root are also loaded as skills.

context-mode declares pi.skills: ["./skills"] in its package.json, and ships skills/UPSTREAM-CREDITS.md at the root of that directory. Pi treats it as a skill, fails frontmatter validation (no description:), and emits a warning every startup.

Relevant pi loader logic: loadSkillsFromDirInternal(..., includeRootFiles: true) for the entry call, which then tries to parse every .md at the root.

Suggested fix

Any one of:

  1. Rename to .txt (or UPSTREAM-CREDITS with no extension). Easiest, zero behavior change.
  2. Move it out of skills/ — e.g. to repo root or docs/. Credits don't really belong inside the skill discovery tree.
  3. Add stub frontmatter with a description and disable-model-invocation: true so it's parsed as a non-invokable skill. Works but is the hackiest option.

Option 1 or 2 seems cleanest.

Environment

  • context-mode v1.0.111
  • @mariozechner/pi-coding-agent (current)
  • macOS

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions