Skip to content

skill frontmatter: non-spec trigger: field — fold into description for Agent Skills spec conformance #1180

Description

@bencharoenwong

Summary

The generated SKILL.md frontmatter (all host variants, checked at v0.8.34) carries a trigger: field:

---
name: graphify
description: "Use for any question about a codebase, ..."
trigger: /graphify
---

trigger is not part of the Agent Skills specification frontmatter schema (name, description, license, compatibility, metadata, allowed-tools).

Why it matters

  1. It's a no-op where it looks load-bearing. Claude Code (and other spec-following hosts) only load name + description at startup for routing — trigger: is silently ignored, so any routing intent encoded there isn't seen unless duplicated in the description (yours already is: the description mentions graphify-out/ query routing).
  2. Spec validators and commit gates now flag it. agentskills validate (skills-ref) rejects unexpected frontmatter fields, and downstream users running spec lint in CI/commit hooks get a standing warning on every graphify upgrade.

Suggested fix

Drop trigger: from the generated frontmatter and (if any variant's trigger text isn't already in its description) fold it into description — that's the only field hosts actually read for routing. The v0.8.x lean-skill redesign (#1106) already moved everything else in the right direction; this is the last non-spec field.

Happy to send a PR if useful.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions