The Pottery Era of Software - When Your 20-Line Skill File Grows to 600+
The Pottery Era of Software
Someone recently described their skill file journey: it started as 20 lines of instructions and grew to 600+ lines of hand-tuned behavior. That's not scope creep. That's craft.
Software as Clay
The pottery metaphor is perfect for what's happening with AI agent configuration. You don't design a pot on paper and manufacture it. You sit at the wheel, shape it, fire it, see where it cracks, reshape, and fire again.
Skill files work the same way. You start with a rough outline - "run my tests, commit the results." Then you notice the agent keeps forgetting to stage specific files. So you add a line. Then it formats commit messages wrong. Another line. Then it runs the wrong test suite on Fridays when the staging server is down. Three more lines.
Why 600 Lines Isn't Too Many
Every line in a mature skill file represents a lesson learned. Line 347 exists because one Tuesday the agent deleted a migration file. Line 512 exists because it kept using the wrong API key for production deploys.
These aren't abstract specifications. They're battle scars turned into instructions. Each one prevents a specific failure mode that actually happened.
The Craft Is in the Iteration
Traditional software development treats specs as something you write once and implement. The pottery era flips this. Your spec is a living document that evolves through daily use. The "code" is the instructions themselves.
This changes who can build software. You don't need to know Swift or Python. You need to know your workflow deeply enough to describe it precisely. Domain expertise becomes the primary skill, not programming language fluency.
What This Means for Tools
The best AI agent tools will be the ones that make skill file iteration fast. Version history, diff views, A/B testing different instruction sets, and rollback when something breaks. The development environment for the pottery era isn't an IDE - it's a skill editor with good undo.
- Context Engineering - Claude MD Is Your Most Important File
- Claude Skills Repeatability - 30 Skills and Reliability
- Skills vs MCP vs Plugins Explained
Fazm is an open source macOS AI agent. Open source on GitHub.