In Managed Deep Agents skills load in two steps, which is why a lean SKILL.md works.
The prompt keeps the name and description. The body opens when the task matches.
docs.langchain.com/langsmithβ¦
Agent skills fail when their instructions are vague and their context is bloated.
Best Practices for Creating Agent Skills is a practical guide for builders writing skills that agents can discover, load, and execute reliably.
It helps you structure skills around lean SKILL.md instructions, just-in-time references, deterministic scripts, and LLM-assisted validation instead of piling everything into one prompt.
Key features:
β’ Standard skill structure β separates core instructions, scripts, references, and reusable assets
β’ Discoverable metadata β explains naming rules and trigger-focused descriptions, including negative triggers
β’ Progressive disclosure β keeps SKILL.md under 500 lines and loads supporting context only when needed
β’ Procedural guidance β favors numbered steps, concrete templates, consistent terminology, and third-person imperative
β’ Validation workflow β covers discovery tests, logic simulation, edge-case testing, and architecture refinement
Free public GitHub repo.
Link in the reply π