AS-009: Description Contains Angle Brackets (Codex)

Summary

• Rule ID: AS-009
• Severity: HIGH
• Category: Agent Skills
• Normative Level: MUST
• Auto-Fix: Yes (safe)
• Verified On: 2026-05-24

Applicability

• Tool: codex
• Version Range: unspecified
• Spec Revision: unspecified

Evidence Sources

• https://github.com/openai/codex/blob/main/codex-rs/skills/src/assets/samples/skill-creator/scripts/quick_validate.py

Test Coverage Metadata

• Unit tests: true
• Fixture tests: false
• E2E tests: false

Examples

The following examples demonstrate what triggers this rule and how to fix it.

Invalid

---
name: review-pr
description: Use when reviewing a <pull-request> for <issues>
---
Check the PR for bugs.

Valid

---
name: review-pr
description: Use when reviewing a pull request for issues
---
Check the PR for bugs.