---
title: "Comment by Adam Lewis on \"AI Skills Are Not Just Prompts: A Practical Architecture for Building, Evaluating, Shipping, and Maintaining Agent Skills\" | Hashnode"
description: "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"
url: "https://hashnode.com/posts/ai-skills-are-not-just-prompts-a-practical-architecture-for-building-evaluating-shipping-and-maintaining-agent-skills/6aac15f545dc150d011be57d/comment/6ab58cc9f3e1d0b4a36a052b"
---

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

Comment [AI Skills Are Not Just Prompts: A Practical Architecture for Building, Evaluating, Shipping, and Maintaining Agent Skills](https://hashnode.com/posts/ai-skills-are-not-just-prompts-a-practical-architecture-for-building-evaluating-shipping-and-maintaining-agent-skills/6aac15f545dc150d011be57d)

[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.
