--- title: Stop Ruining Your AGENTS.md File | daily.dev description: A workflow tip for structuring AI coding agent configuration: keep project-specific rules in an AGENTS.md file, and move tool-specific knowledge (like how to... canonical: https://daily.dev/posts/stop-ruining-your-agents-md-file-sp1yklbzs twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Stop Ruining Your AGENTS.md File | daily.dev og:description: A workflow tip for structuring AI coding agent configuration: keep project-specific rules in an AGENTS.md file, and move tool-specific knowledge (like how to... og:url: https://daily.dev/posts/stop-ruining-your-agents-md-file-sp1yklbzs og:image: https://api.daily.dev/og/posts/sP1yKLBZS.png og:image:alt: Stop Ruining Your AGENTS.md File og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # Stop Ruining Your AGENTS.md File **[JavaScript Mastery](https://daily.dev/sources/javascriptmastery)** · 1 min read · 1 upvotes · 0 comments ## Summary A workflow tip for structuring AI coding agent configuration: keep project-specific rules in an AGENTS.md file, and move tool-specific knowledge (like how to implement Clerk auth or Supabase RLS patterns) into separate reusable 'skill' files. This separation means updating a library only requires editing one skill file, and skills can be carried over to new projects while writing a fresh AGENTS.md. Prompts then simply reference the relevant skill instead of repeating tool-specific instructions. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### What's the difference between an AGENTS.md file and a skill file when working with AI coding agents? AGENTS.md holds project-specific rules and context, while a skill is a dedicated file for a single tool, such as one covering how to implement Clerk authentication or another covering Supabase query patterns and row-level security. This separation means a library update only requires editing its skill file, and skills can be reused across new projects while writing a fresh AGENTS.md each time. _Developers refining agent workflows track patterns like this on daily.dev._ --- Tags: [#ai-agents](https://daily.dev/tags/ai-agents), [#prompt-engineering](https://daily.dev/tags/prompt-engineering), [#supabase](https://daily.dev/tags/supabase) [View this post on daily.dev](https://daily.dev/posts/stop-ruining-your-agents-md-file-sp1yklbzs) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"Stop Ruining Your AGENTS.md File","url":"https://daily.dev/posts/stop-ruining-your-agents-md-file-sp1yklbzs","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/stop-ruining-your-agents-md-file-sp1yklbzs"},"datePublished":"2026-09-03T09:10:20.253Z","dateModified":"2026-09-03T09:11:06.535Z","description":"A workflow tip for structuring AI coding agent configuration: keep project-specific rules in an AGENTS.md file, and move tool-specific knowledge (like how to...","image":"https://i.ytimg.com/vi/eE-XO9haQUo/hqdefault.jpg","thumbnailUrl":"https://i.ytimg.com/vi/eE-XO9haQUo/hqdefault.jpg","isAccessibleForFree":true,"articleSection":"JavaScript Mastery","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"JavaScript Mastery","logo":"https://media.daily.dev/image/upload/s--i6Ls5Q5_--/f_auto/v1724338715/logos/javascriptmastery","url":"https://daily.dev/sources/javascriptmastery"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/stop-ruining-your-agents-md-file-sp1yklbzs","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":1},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"ai-agents,prompt-engineering,supabase","timeRequired":"PT1M","video":{"@type":"VideoObject","name":"Stop Ruining Your AGENTS.md File","description":"A workflow tip for structuring AI coding agent configuration: keep project-specific rules in an AGENTS.md file, and move tool-specific knowledge (like how to...","thumbnailUrl":"https://i.ytimg.com/vi/eE-XO9haQUo/hqdefault.jpg","uploadDate":"2026-09-03T09:10:20.253Z","duration":"PT1M","url":"https://api.daily.dev/r/sP1yKLBZS","embedUrl":"https://www.youtube.com/embed/eE-XO9haQUo"}} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"JavaScript Mastery","item":"https://daily.dev/sources/javascriptmastery"},{"@type":"ListItem","position":3,"name":"Stop Ruining Your AGENTS.md File"}]} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/stop-ruining-your-agents-md-file-sp1yklbzs#faq","mainEntity":[{"@type":"Question","name":"What's the difference between an AGENTS.md file and a skill file when working with AI coding agents?","acceptedAnswer":{"@type":"Answer","text":"AGENTS.md holds project-specific rules and context, while a skill is a dedicated file for a single tool, such as one covering how to implement Clerk authentication or another covering Supabase query patterns and row-level security. This separation means a library update only requires editing its skill file, and skills can be reused across new projects while writing a fresh AGENTS.md each time. Developers refining agent workflows track patterns like this on daily.dev."}}]} ```