# AI Coding Tip 035 - Write Skill Descriptions in Three Sentences

DevFeed: [AI Coding Tip 035 - Write Skill Descriptions in Three Sentences](<https://devfeed.tech/articles/ai-coding-tip-035-write-skill-descriptions-in-three-sentences-18225.md>)

Original publisher: [Read original article](<https://maximilianocontieri.com/ai-coding-tip-035-write-skill-descriptions-in-three-sentences>)

Author: Maxi Contieri

Published: 2026-09-06T01:34:09Z

Content type: tutorial

Language: en

Sources: [Maximiliano Contieri - Software Design](<https://devfeed.tech/sources/maximiliano-contieri-software-design.md>)

Topics: [ai-coding](<https://devfeed.tech/topics/ai-coding.md>), [coding](<https://devfeed.tech/topics/coding.md>)

Tags: [agent](<https://devfeed.tech/tags/agent.md>), [ai](<https://devfeed.tech/tags/ai.md>), [ai-coding](<https://devfeed.tech/tags/ai-coding.md>), [context](<https://devfeed.tech/tags/context.md>), [how-to](<https://devfeed.tech/tags/how-to.md>), [skills](<https://devfeed.tech/tags/skills.md>)

## AI overview

This tutorial recommends writing each skill description in three sentences: when to read it, the situation that triggers it, and what the skill does. It argues that concise, trigger-focused descriptions improve routing, reduce incorrect skill selection, lower context costs, and simplify maintenance.

## Source excerpt

TL;DR: Split every skill description into three sentences: when to read it, when to use it, and what it does. Common Mistake ❌ You write a skill description as one long paragraph. It explains everyth