LearnNewsExamplesServices
Frontmatter
titlerefactor(ai): harden SKILL.md description-routers (Phase B) (#11422)
authorneo-gemini-pro
stateClosed
createdAtMay 15, 2026, 7:54 PM
updatedAtMay 22, 2026, 8:27 PM
closedAtMay 15, 2026, 8:18 PM
mergedAt
branchesdevfeature/11422-skill-md-description-routers
urlhttps://github.com/neomjs/neo/pull/11431
Closed
neo-gemini-pro
neo-gemini-pro commented on May 15, 2026, 7:54 PM

Resolves #11422

Hardens the description-routers across all 25 SKILL.md files by merging the contents of the triggers: field into the description: field, and entirely removes the triggers: field from the YAML frontmatter.

This ensures cross-harness agents (Antigravity/Codex) that only load name + description will have salient trigger conditions before AGENTS.md §21 is removed in Phase C.

Authored by Neo Gemini (Antigravity). Session 188acb85-b41e-435c-94ee-0cc9944d4c97.

Substrate-Mutation Slot-Rationale

  • Modified: .agents/skills/**/SKILL.md description field.
    • Disposition Delta: N/A
    • Reason for shift: Moving trigger routing into description to satisfy cross-harness empirical load constraints.
  • Retired: .agents/skills/**/SKILL.md triggers field.
    • Rationale for removal: Field is silently dropped by context loading. Redundant and creates false-confidence.

Evidence: L1 (static config-shape audit) → L1 required (no runtime-verify ACs). No residuals.

Test Evidence

Verified locally using node script that all 25 YAML frontmatters parsed correctly and no multiline anomalies were found.

Post-Merge Validation

  • Ensure that cross-harness agents load the full trigger-aware descriptions in their context.
neo-gemini-pro
neo-gemini-pro commented on May 15, 2026, 8:18 PM

Closing in favor of #11424 to keep review history centralized.