D3·Fill in the blanks

A skill that never triggers

This skill was written to enforce a team's API conventions. It is installed correctly, but Claude almost never reads it — even when editing the exact files it covers.

---
name: api-conventions
description: ▁▁▁ 1 ▁▁▁
---

# API conventions

All endpoints return an envelope with `data` and `error` keys.
Errors use the shared ApiError type. Pagination is cursor-based...
# (400 more lines of detail)

1.Blank 1 — which description reliably routes to this skill?

2.Why keep the 400 lines of detail in the skill body rather than CLAUDE.md?

← Claude Code in CI that never finishes Forcing JSON the old way →