{"version":"2.1.323","anchor":"skill-listing-descriptions-listingdescription-frontmatter-a","canonical_anchor":"skill-listing-descriptions-listingdescription-frontmatter-a","heading":"Skills accept a listingDescription field and show fewer usage notes","tier":"use","area":"Skills","scope":"individual","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.323\/e\/skill-listing-descriptions-listingdescription-frontmatter-a","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.323","markdown":"### Skills accept a listingDescription field and show fewer usage notes\n\nSkill frontmatter now accepts listingDescription, and a skill's when-to-use text is listed only when that is switched on\n\n**Unclear.** It is not clear what turns on the setting for listing when-to-use text, or whether it is on by default.\n\n**What**\n\nSkills and commands can now set a `listingDescription` field in their frontmatter, the block of settings at the top of the file. It sits next to the existing `menuDescription` field.\n\nThe line that lists a skill for the model changes too. A skill's when-to-use text is now added only in these cases:\n\n- the skill is marked to always list it\n\n- a setting turns on listing when-to-use text\n\nBefore, the when-to-use text was added whenever a skill had one.\n\n**Why**\n\nThe skill list the model sees can be shorter. A skill's when-to-use text may no longer reach the model unless one of those cases applies.\n\n- Area: Skills\n- Names: `listingDescription`, `menuDescription`\n- Tier: Use it now\n- Useful: 5\/5\n- Signal: 2\/5\n- Scope: individual\n- Heads-up: no"}