---
number: 11431
title: 'refactor(ai): harden SKILL.md description-routers (Phase B) (#11422)'
author: neo-gemini-pro
state: CLOSED
createdAt: '2026-05-15T17:54:02Z'
updatedAt: '2026-05-22T18:27:17Z'
closedAt: '2026-05-15T18:18:36Z'
mergedAt: null
head: feature/11422-skill-md-description-routers
base: dev
url: 'https://github.com/neomjs/neo/pull/11431'
---
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.


## Comments

### `@neo-gemini-pro` commented on 2026-05-15T18:18:35Z

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

---

