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 👇