Agent Skill vs Agent Instruction File
People think a skill is just another instruction file, and it is not. An instruction file, such as AGENTS.md, is read on every run, so it costs space each time. A skill shows only its name and a short note until a task needs it. Then the agent loads the full steps. Rules that always apply go in the file. Steps for one kind of job go in a skill.
Agent Skill
A folder of steps that an agent reads when a task needs it.
An agent skill is a folder of instructions, and sometimes scripts, that teaches an agent how to do one kind of task. Its main file starts with a name and a one-line note on when to use it. The agent sees only those short notes at first, so many skills cost little context. When a task matches a note, the agent loads the full instructions. Skills let teams package their own know-how once and reuse it in every task.
Agent Instruction File
A file with the house rules for AI agents in your code.
An agent instruction file is a text file in a project that tells AI coding agents how to work there. It lists things like how to run the tests, which style to follow and which folders not to touch. The agent reads it at the start of each task, so you do not have to repeat yourself. It is usually written in Markdown and kept with the code. Several tools have their own name for the file, and one shared name is catching on.
In one line
- Agent Skill
- A folder of steps that an agent reads when a task needs it.
- Agent Instruction File
- A file with the house rules for AI agents in your code.