4 ms·
> But skills are not fundamentally different from *.instruction.md prompt in Copilot or AGENT.md and its variations. One of the best patterns I’ve see is havin
by electric_muse 10mo ago
> But skills are not fundamentally different from *.instruction.md prompt in Copilot or AGENT.md and its variations.
One of the best patterns I’ve see is having an /ai-notes folder with files like ‘adding-integration-tests.md’ that contain specialized knowledge suitable for specific tasks. These “skills” can then be inserted/linked into prompts where I think they are relevant.
But these skills can’t be static. For best results, I observe what knowledge would make the AI better at the skill the next time. Sometimes I ask the AI to propose new learnings to add to the relevant skill files, and I adopt the sensical ones while managing length carefully.
Skills are a great concept for specialized knowledge, but they really aren’t a groundbreaking idea. It’s just context engineering.
- tedivm 10mo agoBack in my day we referred to this as "documentation". It turns out it's actually useful for developers too, not just agents.
- abirch 10mo agoWait developers RTFM?
- itsafarqueue 10mo agoOnly after exhausting every other avenue
- pbronez 10mo agoI’ve seen some dev agents do this pretty well.
- CuriouslyC 10mo agoPro tip, just add links in code comments/readmes with relevant "skills" for the code in question. It works for both humans and agents.
- _pdp_ 10mo agoThis is exactly what I do. It works super well. Who would have thought that documenting your code helps both other developers and AI agent? I've been sarcastic.
- smoe 10mo agoI would argue that many engineering “best practices” have become much more important much earlier in projects. Personally, I can deal with a lot of jank and lack of documentation in a early stage codebase, but LLMs get lost so quickly, or they just multiply the jank faster than anyone ever could have in the past, making it much, much worse for both LLMs and humans. Documentation, variable naming, automated tests, specs, type checks, linting. Anything the agent can bang its proverbial head against in a loop for a while without involving you every step of the way.
- scottlamb 10mo agoThis might be one of the best things about the current AI boom. The agents give quick, frequent, cheap feedback on how effective the comments, code structure, and documentation are to helping a "new" junior engineer get started. I like to think I'm above average in terms of having design docs alongside my code, having meaningful comments, etc. But playing with agents recently has pointed out several ways I could be doing better.
- Leynos 10mo agoIf I see an LLM having trouble with a library, I can feed its transcript into another agent and ask for actionable feedback on how to make the library easier to use. Which of course gets fed into a third agent to implement. It works really well for me. Nothing more satisfying than a satisfied customer.
- CuriouslyC 10mo agoI've done something similar. I ask agents to use CLIs, then I give them an "exit survey" on their experience along with feedback on improvements. Feels pretty meta.