Skip to content
Join our email list to get $80 off Ally in November →
R for the Rest of Us Logo

Ally Lesson

Use AGENTS.md files and skills together

Free preview: first minute

Transcript

Click on the transcript to go to that point in the video. Please note that transcripts are auto generated and may contain minor inaccuracies.

I wanted to answer a question I keep hearing: when should instructions go in an AGENTS.md file, and when should they go in a skill? I walk through how I split the two, using the data tidying skill from an earlier lesson as the example.

You'll learn:

  • How to tell general, high-level agent instructions apart from task-specific guidance
  • What belongs in an AGENTS.md file, such as a preference for tidyverse-style code or how responses should be written
  • How to decide when a task like data tidying should be a skill instead of part of your global instructions
  • Why keeping specific guidance in a skill means the agent only gets it when you invoke it, so data tidying guidance stays out of the way when you are making graphs or a Quarto document

Tools mentioned:

Key moments:

  • 00:03 Two types of instruction files for AI agents
  • 00:22 Skills files and the data tidying example
  • 00:40 The core question: AGENTS.md or skills?
  • 00:52 AGENTS.md as general instructions
  • 01:21 Skills as guidance for specific tasks
  • 01:51 Summary of what goes where