{
  "id": 9840783,
  "title": "Teach Claude your workflow: build an Agent Skill with SKILL.md",
  "url": "https://urgent.news/2026/09/25/teach-claude-your-workflow-build-an-agent-skill-with-skill-md",
  "topic": "ai",
  "section": "AI",
  "published": "2026-09-25T21:21:33.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/aifrontierpost/teach-claude-your-workflow-build-an-agent-skill-with-skillmd-2c28"
  },
  "original_language": "en",
  "account": "Teaching workflows to Claude is often challenging because users have to re-explain their processes in each session. Agent Skills are the solution to this issue, allowing workflows to be defined and automatically executed by the agent. Anthropic introduced Agent Skills as a Claude feature in October 2025, and by mid-2026, around forty products were able to utilize these skills.\n\nSKILL.md is the core of an Agent Skill, containing a simple Markdown file with YAML metadata and instructions. To create an Agent Skill, you need a coding agent that supports the open standard, a text editor, Python 3, and a repeatable workflow. The tutorial provided builds a changelog writer as an example, but it can be adapted to any workflow.\n\nThe skill folder must be named after the skill in the frontmatter, and it should contain only one required file: SKILL.md. The YAML frontmatter includes the skill's name and description, which tells the agent what the skill does and when to use it. The body of SKILL.md outlines the steps to follow, rules, output expectations, and edge cases. Skills can also include sub-directories for scripts, references, and assets, but the progressive disclosure approach ensures that only the necessary components are loaded when needed, allowing skills to scale without the overhead of large system prompts.",
  "summary": "Originally published at AI Frontier Post . Every regular Claude user eventually hits the same wall: a workflow they repeat every week — the way they want release notes written, code reviewed, or research briefs formatted — that they have to re-explain in every single session. Paste the checklist again. Correct the format again. Watch the agent improvise the steps you already decided. The…",
  "key_points": [
    "Agent Skills enable workflows to be defined and executed by Claude",
    "SKILL.md is the core Markdown file with YAML metadata and instructions",
    "Example skill: changelog writer built in tutorial"
  ],
  "editors_take": null,
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}