---
title: "Discussion on \"AI Skills Are Not Just Prompts: A Practical Architecture for Building, Evaluating, Shipping, and Maintaining Agent Skills\" | Hashnode"
description: "Discussion on \"AI Skills Are Not Just Prompts: A Practical Architecture for Building, Evaluating, Shipping, and Maintaining Agent Skills\". The current generation of AI coding agents makes it surprisingly easy to create a \"skill.\"\nWrite a Markdown file. Add instructions. Give it a name. Put it inside .claude/skills/. Done.\nExcept it isn't"
url: "https://hashnode.com/posts/ai-skills-are-not-just-prompts-a-practical-architecture-for-building-evaluating-shipping-and-maintaining-agent-skills/6aac15f545dc150d011be57d"
---

[Feed](https://hashnode.com/feed) /

Discussion

# [AI Skills Are Not Just Prompts: A Practical Architecture for Building, Evaluating, Shipping, and Maintaining Agent Skills](https://blog.nishikanta.in/ai-skills-are-not-just-prompts-a-practical-architecture-for-building-evaluating-shipping-and-maintaining-agent-skills?utm_source=hashnode&utm_medium=feed)

The current generation of AI coding agents makes it surprisingly easy to create a "skill." Write a Markdown file. Add instructions. Give it a name. Put it inside .claude/skills/. Done. Except it isn't

Sep 17 · 22 min read · blog.nishikanta.in  
Read the article

## Written by

[Nishikanta Ray](https://hashnode.com/@nishikanta236)

@nishikanta236 · India

  
[View profile](https://hashnode.com/@nishikanta236)

Fullstack Developer

## Responses 1

Markdown supported · ⌘↵ to post

[Adam Lewis](https://hashnode.com/@nark3d)

[Sep 24](https://hashnode.com/posts/ai-skills-are-not-just-prompts-a-practical-architecture-for-building-evaluating-shipping-and-maintaining-agent-skills/6aac15f545dc150d011be57d/comment/6ab58cc9f3e1d0b4a36a052b)

Your repo is where the spec has to live, javadoc or markdown, because the agent goes back to it while it works and a skill file in a separate location gets read once at the start. What broke for me was treating the skill as the artefact and the spec as documentation, so the two drifted and the agent followed whichever it hit last. Now the spec is the thing I review and the skill file is just how it gets loaded. The location matters less than the habit.
