yeah, thats what they are, but thats useful! you have an agents.md, that gets put into every conversation. But studies and experience both show that as that gets longer, the agent becomes less capable. so instead of telling it everything useful under the sun, you put only really important things there, and the rest of the advice for common but not every time actions you put into skills. I personally have like, 5 skills. one that works with the database, and has a bunch of context about the schema, how to connect and work with documents, example queries written just how I like them (and pre-written with filters to reduce the risk of ai ingesting a million rows worth on tokens for no reason), a python script I wrote to do certain common operations and how to use it for different tasks.

So in essence, the ideal skill imo is pretty much a list of shell commands with a sentence next to each of when to use them

With these, I personally have skills for:

- dealing with our metrics and tracing platform

- dealing with jira

- dealing with confluence (mostly finding info I need via different search strategies without using too many tokens)

- dealing with database

- doing reviews (this one is more prompting about what info I need to review well myself, rather than commands, though it does instruct the agent to download the branch into a new worktree and clean it up after its done with specific commands)

Im generally suspicious of people with hundreds of skills, especially those I open and find ai generated writing inside. skills should be a list of commands, maybe with some pitfalls for the agent to avoid, added only by human experience (agents are terrible at prompting)