{"slug": "make-ai-agent-skills-that-work-the-way-you-do", "title": "Make AI Agent Skills that Work the Way You Do", "summary": "Network engineers can now teach AI agents their specific workflows using agent skills, a new capability that lets users define repeatable tasks in a SKILL.md file without writing code. The skills, which include optional scripts, references, and assets folders, enable AI to execute tasks like pulling logs or running Ansible playbooks on demand. The approach uses progressive disclosure, where only the skill's description is visible by default, and the full workflow loads only when relevant.", "body_md": "So, you’re a network engineer. You live in the CLI. You SSH into your devices. You work on your tickets. You read your logs. You get things done the way you’ve always gotten them done.\n\nAnd like everyone else right now, you’re asking yourself how AI fits into your daily routine.\n\nImagine this. What if you could teach AI how *you* work, right inside the environment you already live in? What if you could hand off the repeatable stuff while you stay in the loop—without needing to learn a stitch of code?\n\nNo more imagining. It’s an AI reality, and this* AI Break* will teach you how. Plus, it doesn’t take moving your entire work life into some new tool—just your workflow, your terminal, and an agent that works the way you do.\n\nIt’s called an **agent skill. **The easiest way to think about agent skills is the way you think about your own.\n\nYou picked up a packet capture trick years ago, and it’s been on your tool belt ever since. Learn it once, reach for it forever. An agent skill is the same thing, passed on to your AI.\n\n**What is an agent skill, really?**\n\nA skill teaches your AI how to handle a specific task the way you’d handle it. Instead of re-explaining your process every conversation, you teach it once and get the payoff every time it runs.\n\nThink about years of expertise in your head right now. For example, a ticket lands and you already know the moves: Check this before you touch that. Pull these logs. Verify in a set order. You’ve never written it down because you’ve never had to. It just lives *rent-free* in your head. A skill is your expertise, written down, one time, for the AI.\n\n**Why agent skills are better than prompts:**\n\n**A prompt is disposable.** Close the window, and it’s gone. Next time, you start over.**An agent’s skill sticks around.** It loads when the work calls for it and runs the same way every time.**Skills stack.** You build small ones that each do a job well, and the agent grabs the right one when the moment calls for it. Over time, you’ve got a whole library working together.- Skills can be shared. The benefits can become exponential by sharing across teams. Think repository of tried-and-true best practices.\n**MCP gives it hands.** On its own, a skill is just knowledge. Wire in MCP and it can pull the real ticket, read the live config, and act on what it finds, with you approving every step that matters.\n\n**How agent skills are built**\n\nA skill is a directory. `SKILL.md`\n\ndoes the work: YAML frontmatter on top, a Markdown body underneath.\n\nThe frontmatter is metadata. Two fields to start:\n\n`name`\n\n: kebab-case, matched to the folder`description`\n\n: what the skill does and when to load it, under 1024 characters\n\nDon’t sleep on that `description`\n\n. It’s the only part the agent sees by default, so it decides whether the rest even loads.\n\nThat’s *progressive disclosure*: The body loads only when it’s relevant and reference files only when the agent reaches for them. Too vague, and the skill never wakes up. Too broad, and it fires when you don’t want it to.\n\nThe body is your workflow, plus three optional folders:\n\n`scripts/`\n\n: code the agent runs`references/`\n\n: docs it pulls on demand`assets/`\n\n: templates it works from\n\nThis is where prompt engineering earns its keep. The body is a prompt, and the agent does what it says. “Generate the report” leaves it guessing. Spell out the format and the sections, and you get the same result every time. For steps that can’t drift, call a script instead of trusting ever-changing prose.\n\nAnd here’s the part that should make every network engineer sit up. That `scripts/`\n\nfolder is where your automation comes back to life. The Ansible playbooks you wrote for deployments, the Terraform plans that stand up your infrastructure, the scripts you’ve built over years of network ops: none of it is wasted. You drop it in `scripts/`\n\n, and the agent runs it on your terms, when your skill tells it to. Your automation doesn’t compete with AI. It becomes the tool the agent reaches for. The work you already did just got more valuable.\n\n**Let the AI come to you**\n\nThe core idea is not locked to one vendor. Agent skills are an open standard. This means the basic building blocks can move across skills-compatible agents. The details may change from tool to tool, but the pattern holds.\n\nTo build something real, though, I must pick one. For my use case, my AI of choice is Anthropic’s Claude, running in Claude Code. And the reason matters more than the brand.\n\nMost AI shows up as a chat window or a panel bolted onto an IDE. Useful, but it’s not where we work. We work in the terminal. We SSH into boxes, run `show`\n\ncommands, pipe output through grep, and live at the prompt.\n\nClaude Code runs right there in the CLI. The agent meets you in your environment instead of asking you to move into its. No new IDE to learn. No “rewrite your life in Python first.” You stay at the terminal you already know, and the AI comes to you.\n\nThat’s the unlock for network engineers. You don’t have to become a developer to get the payoff. You bring your skill, your terminal, and your judgment, and the agent works alongside you right where you already are.\n\nFrom here, the filenames get Claude-flavored. The pattern still maps to whatever agent you run. Only the names change.\n\n**Meet Iris, an agent skill for network operations**\n\nI built one. It’s called [Iris](https://github.com/kiskander/iris): the network agent that keeps an eye on your network. It also happens to be my daughter’s name, so it felt fitting for a skill that watches over things. [It’s on my GitHub.](https://github.com/kiskander/iris) It’s a working agent skill for network operations, and **you can clone it today**.\n\nThe idea is simple. You still own every decision. Iris handles the work around those decisions: pulling device state, checking it against your source of truth, running pre-condition checks, drafting the change, verifying it after, and writing it up in the ticket. Iris is built from the exact blocks we just covered. Here’s how they map.\n\n**`CLAUDE.md` is the operating contract.** Iris’s persona and its guardrails in one file. The rules are the part that matters:\n\n- Discover before you assume\n- Verify before you change\n- Never push a change without explicit approval\n- Stop if something looks wrong\n- Close the ticket with enough detail that the next engineer can reconstruct what happened\n\nYou’re handing an agent access to your network, so those rules aren’t decoration. They’re what keep it from doing something catastrophic at 2 a.m.\n\n**`SKILL.md` is the brain.** The workflow Iris runs on every ticket, in the same order every time:\n\nThe discipline doesn’t change whether you’re touching Catalyst CLI, the Meraki dashboard, or a Terraform plan. And human-in-the-loop is baked into the workflow itself. Iris proposes a plan and waits for your “yes” before it touches anything. It’s not a setting you remember to turn on.\n\n**The `.claude` folder and `.mcp.json` are the connections.** This is where Iris gets its hands. The MCP wiring points at the systems you run. You don’t need all of them, but the more you connect, the more Iris can do:\n\n**Ticketing**: ServiceNow, Jira** Device management**: CML, Meraki, Catalyst Center, direct CLI** Source of truth**: NetBox** Observability**: Splunk, ThousandEyes\n\nTwo more folders are worth knowing:\n\n`environment/`\n\nis where Iris learns what your network looks like on first run, pulling from your MCPs, your docs, and any discovery scripts you drop in.`automation/`\n\nis that tool belt from earlier. Drop your playbooks and scripts in, and Iris learns them, tags each one read-only or state-changing, and only runs the state-changing ones you approve.\n\nNow picture a skill on the job. A ticket comes in: a new VPC needs to reach an on-prem staging environment. Normally you are the one reading the ticket, checking what’s deployed, working out the routing and the firewall path, then SSHing in to make it happen.\n\nWith Iris, the AI agent is doing most of the work:\n\n- Restates the ticket in plain language and confirms before touching anything.\n- Discovers what’s actually out there instead of assuming.\n- Validates pre-conditions and stops if a check fails.\n- Proposes a plan that includes the exact commands, exact API calls, and expected outcomes.\n\nYou approve or push back, because you’re the engineer, and you know what right looks like. Only then does the agent execute, verify, and document.\n\nYou never left the terminal. You never stopped being the one in charge. The agent handled the busywork while you kept your eyes on the network.\n\n**Build your own agent skill**\n\nHere’s the thing about Iris: it’s a starting point, not a destination. It works the way *you* work. Your network is different, your process is different, your guardrails are different.\n\nTake it and make it yours:\n\n**Clone the repo.** It’s on GitHub, MIT licensed.`git clone`\n\nand you’re in.**Edit `CLAUDE.md` and `SKILL.md`.** Change the rules to match your shop. Change the workflow to match how you and your network operate.**Wire your own `.mcp.json`.** Point it at your ticketing, your devices, your source of truth. Connect what you’ve got.**Drop in your automation.** Those playbooks and scripts you already trust go in`automation/`\n\n, and the agent runs them on your say-so.\n\nIf you want to go deeper on the skill format itself, [Anthropic’s guide to building](https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf) skills is the best reference out there, and there’s a skill-creator that walks you through building one from scratch. I’ll link both below.\n\nThe bigger point is this. Your job is not going away, and you’re not being replaced by an agent that pushes config while you sleep. What’s changing is how the work gets done. The engineers who get ahead are the ones who teach the AI their craft and stay in the loop to catch what it misses. Your knowledge is what makes any of this safe. The skill is just how you hand some of it off.\n\nClone Iris, break it, rebuild it, and make it work the way you do. That’s the whole point. A tool belt only works if it fits.\n\n*Frequently asked questions about agent skills*\n\n*Frequently asked questions about agent skills*\n\n**What is an agent skill?**\n\nAn agent skill is a reusable set of instructions that teaches your AI how to handle a specific task—your way, every time. The easiest way to think about it: you’ve spent years developing instincts for your job. A ticket lands and you already know the moves. An agent skill is that expertise, written down once, so your AI can run it the same way every time without you re-explaining it from scratch.\n\n**How do I create an agent skill?**\n\nA skill is a directory, and `SKILL.md`\n\ndoes the work. Start with YAML frontmatter—a `name`\n\nand a `description`\n\n—then write your workflow in Markdown underneath. That’s the brain. From there, three optional folders extend what it can do: `scripts/`\n\nfor code the agent runs, `references/`\n\nfor docs it pulls on demand, and `assets/`\n\nfor templates it works from. The description field matters more than anything else—it’s the only part the agent sees by default, and it decides whether the rest even loads.\n\n**What’s the difference between an agent skill and a prompt?**\n\nA prompt is disposable. Close the window and it’s gone. Next time, you start over. A skill sticks around—it loads when the work calls for it and runs the same way every time. Skills also stack. You build small ones that each do one job well, and over time you’ve got a library the agent pulls from automatically. A prompt is a one-time conversation. A skill is institutional knowledge.\n\n**Can agent skills be shared across teams?**\n\nYes—and that’s where they get powerful. One engineer builds a skill that reflects years of hard-won process, and the whole team inherits it. Think of it as a repository of tried-and-true best practices. The knowledge that used to live in one person’s head, now accessible to everyone who needs it.\n\n**Do I need to know how to code to build an agent skill?**\n\nNo. You can teach your AI how you work right inside the environment you already live in—no coding required. And if you’ve already got automation built up over the years—Ansible playbooks, Terraform plans, scripts from a career in network ops—none of it is wasted. Drop it into the `scripts/`\n\nfolder and the agent runs it on your terms, when your skill tells it to. Your existing work doesn’t compete with AI. It becomes the tool the agent reaches for.", "url": "https://wpnews.pro/news/make-ai-agent-skills-that-work-the-way-you-do", "canonical_source": "https://blogs.cisco.com/learning/make-ai-agent-skills-that-work-the-way-you-do", "published_at": "2026-07-21 15:24:53+00:00", "updated_at": "2026-07-22 00:11:41.654402+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "artificial-intelligence"], "entities": ["Ansible", "Terraform", "MCP"], "alternates": {"html": "https://wpnews.pro/news/make-ai-agent-skills-that-work-the-way-you-do", "markdown": "https://wpnews.pro/news/make-ai-agent-skills-that-work-the-way-you-do.md", "text": "https://wpnews.pro/news/make-ai-agent-skills-that-work-the-way-you-do.txt", "jsonld": "https://wpnews.pro/news/make-ai-agent-skills-that-work-the-way-you-do.jsonld"}}