Write a specific description: in a team repo

Tip: The description is the router

Say when to use the skill in the frontmatter description; that is what the agent scans first. Commit the skill and changelog the behavior so caches do not drift.

---
name: lexprog-import-tips
description: Import JSONL tips into blog.db via import_expanded
---

Gotcha: description: helper utilities (in a team repo)

The skill will never be picked for the actual job. A personal ~/.skill that nobody else has will look like model drift.

description: various helpers

Source: https://docs.cursor.com/context/skills